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PREFACE 



This manual is directed at programmers using COMPASS Version 1 for the CONTROL DATA® 7600 
Computer System under control of the SCOPE 1, COMPASS Version 2 for the CONTROL DATA 7600 
Computer System under control of SCOPE 2, and COMPASS Version 2 for the CONTROL DATA® 
6000 Series Computer Systems under control of the SCOPE 3.3 Operating System. 

This manual describes the principles, features, methods, rules, and techniques of producing a 
COMPASS language program. It does not describe instructions unique to CONTROL DATA® CYBER 
70 Series Computer Systems. 

The user is assumed to be familiar with either the CONTROL DATA 6000-Series Computer Systems 
or with the CONTROL DATA 7600 Computer System and is assumed to be familiar with assemblers 
in general. Familiarity with the related 6000 or 7600 Operating System is helpful. 

Readers with no previous experience with 6000 COMPASS or 7600 COMPASS assemblers are encouraged 
to direct their initial attentions to the following sections of this manual. 

Chapter 1 Introduction 

Chapter 2 Language Structure 

Chapter 3 Program Structure, sections 3.1 through 3.3 

Chapter 4 Pseudo instructions, sections 4. 1 and 4. 2 

Chapter 8 or 9 CPU or PPU Symbolic Machine Instructions, the chapter depending upon the 

machine language the user requires. 



Chapter 10 Program Execution 

This manual is not intended to replace the 6400/6500/6600/6700 Computer Systems Reference Manual, 
Pub. No. 60100000 or the 7600 Computer System Reference Manual, Pub. No. 60258200 to which the 
user is referred for detailed information on machine instructions. Information in Pub. No. 60100000 
and Pub. No. 60258200 takes precedence over information in this manual if discrepancies should arise 
between these publications. 

In this manual, numbers occurring in text are decimal unless otiierwise noted. Lower case letters in 



formats depict variables. The examples assume that assembler numeric mode is decimal and that 
character mode is display code unless otherwise noted. In examples, statements generated uy tue 
assembler as a result of a call or a substitution are shown in shaded print. 
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INTRODUCTION 



The CONTROL DATA COMPASS Assembler provides the user with a versatile, extensive language for 
generation of object code to be loaded and executed on the central processor unit (CPU) or a peripheral 
processor unit (PPU). The assembler executes on either a CONTROL DATA 7600 Computer System or 
a CONTROL DATA 6000-Series Computer System. 

Subprograms to be executed on a 7600 system can be assembled on a 6000-Series system and vice versa. 
However, the user must use only instructions accepted by the system on which the object program is 
to be executed. 

From CPU source language subprograms, the COMPASS assembler generates binary output acceptable 
for loading and execution by a 6000 or 7600 central processor unit under SCOPE control. Subprograms 
can be compiled independently for subsequent loading and execution as a single program. 

From PPU source language programs, the COMPASS assembler generates absolute code to be loaded 
and executed on a peripheral processor unit of a 7600 or a 6000 Series Computer System. 



Source statements consist of CPU or PPU symbolic machine instructions and pseudo instructions. The 
symbolic machine instructions (chapters 8 and 9) are counterparts of the binary machine instructions; 
they provide a means of expressing symbolically all functions of the Computer System. 



The pseudo instructions are oriented towards control of the assembler itself; they control the assembler 
much the same as machine language instructions control the computer. The ability to control assembly 
places COMPASS at a level of sophistication much higher than that of the conventional assembler. 

Features inherent to COMPASS include: 

• Free-field source Size of source statement fields is largely controlled by user, 
statement format 

• Control of local Programmer and system designate up to 255 areas to facilitate inter- 
and common blocks program communication. In CPU programs, common areas can be 

defined in small core memory (CM or SCM) or extended or large core 
memory (ECS or LCM). 

• Preloaded data Data areas may be specified and loaded in small core memory (CM or 

SCM) with the source program, t 

• Data notation Data can be designated in integer, floating-point, and character code 

notation. It can-be introduced into the program as a dataitem, a 
constant, or a literal. 

• Address arithmetic Addresses can be specified making extensive use of constants, symbolic 

addresses, and arithmetic expressions. 



~. o. 



Syrnboi equation and Equation and redefinition of symbols allow extensive parameterization of 

redefinition assembly and linkage of subprograms and subroutines. 



tCOMPASS Version 2 under SCOPE 2 allows data to be loaded into LCM. 
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Symbol qualification 



• Binary control 



• Selective assembly 
of code sequences 



• Listing control 

• Micro coding 

• Macro coding 

• Operation code table 



• Operation code 
definition 



• Code repetition 

• Remote assembly 

• Library routine 
calls 

• Diagnostics 



Ability to associate a symbol qualifier with a symbol defined within a 

qualified sequence to render the symbol unique to the sequence. An 

unqualified symbol is global and can be referred to from within any 

sequence without qualification. 

The programmer can specify whether binary output is to be absolute or 

relocatable. Absolute code can be generated for any PPU or CPU. 

Relocatable code can be generated for any CPU. Binary can be written 

as overlays or as partial records. 

Assembly-time tests allow the user to select or alter code sequences. 

Ability t<-> sr.An.ifv the base to be used for numeric notation not explicitly 
defined as octal or decimal, and to specify the code conversion to be 
applied to character data as either display code, ASCII, internal BCD, 
or external BCD. 
Assembly-time control of list content. 

Substitution of sequences of characters defined in the program whenever 

the micro name is referenced. DATE and TIME are predefined by the 

system. 

Assembly of sequences of instructions defined in the program or on the 

system library whenever the macro name is referenced. Macro 

definitions can be redefined or purged from the operation code table. 

The programmer can specify or respecify the syntax of a CPU or PPU 
instruction. The assembler generates an entry in the operation code 
table for the instruction. No macro or opdef definition is associated 
with the entrv. 

Assembly of sequences of instructions defined in the program or on the 
system library whenever an operation code of the specified syntax is 
referenced. 

Sequences of code can be repeated during assembly or at load time. 

Defers assembly of defined coding sequence until later in the assembly. 

Routines can be called from the system library. 



Diagnostics for source program errors are included on ouiput listing. 
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1.1 OPERATING SYSTEM INTERFACE 

COMPASS Version 1 executes on a 7600 CPU under control of the SCOPE 1 Operating System; COMPASS 
Version 2 executes on a 6000-series computer system CPU under control of the SCOPE 3. 3 Operating 
System or on a 7600 computer system under control of the SCOPE 2 Operating System. 

1.2 CONFIGURATION 

The hardware requirements for executing COMPASS on a CPU are the minimum required for the 
ope ratine system. 



1.3 ASSEMBLER EXECUTION 

COMPASS is called from the system library by a COMPASS control card (chapter 10) or by a compiler 
such as RUN or FTN upon encountering a COMPASS IDENT statement in the source input file. 
Parameters on the card specify files used during the assembler run such as the file containing source 
statements and the files to receive listable output and load-ahd-go output. The COMPASS assembler 
executes as a CPU program. 

The operating system allocates the input/output resources as needed and performs all input/output 
required during the assembly. 

COMPASS assembles each subprogram on the source file, in turn, in two passes. During the first 
pass, it reads each source language instruction, expands and edits called sequences as needed, 
interprets the operation code, and assigns storage. 

The function of the second pass is to assign block origins, locate literals, fill in all valid symbol values 
and produce the assembly listing and binary output. Finally, it prepares the symbolic reference table 
and reinitializes itself preparatory to assembling the next subprogram. 

Core requirements for tables used by the assembler are dynamically changed as requirements change 
during assembly. If insufficient core is available for the program, the intermediate file and cross- 
references are transferred to the system mass storage device and assembly continues. 

All nested processing of macros and similar definitions is handled in a single recursive push-down 
stack. COMPASS has a recursion level of 400; that is, COMPASS allows nesting to a depth of 400. 

1.4 RELOCATABLE OBJECT PROGRAM EXECUTION 

When the assembler has completely processed the source deck, the programmer can use a SCOPE 
control card to call for loading and execution of a CPU object program from the load-and-go file. 
The loader links the newly asseniuied subprogram to any previously assemuieu subprograms anu sub- 
routines referred to by the new program and to programs on any other files specified by the programmer. 
After all subprograms are loaded and linked, the operating system uegins program execution^ an. a 
location specified by one of the subprograms. Data for the object program may be on some programmer- 

• JJ» 1 J»»l - "kT 11 il_ • _ 1 1* 3 t.3 J i. i.-»1 1~ ifiL. OATlffTIA OO nnnniMV^l A-M 

specmea me. normally, tills tuauiiig aaju baeuuuuu uucb ikjl utuve piauc n uic ^uiurnoo aoociuuici 

detects fatal errors. 
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LANGUAGE STRUCTURE 



2.1 STATEMENT FORMAT 

A COMPASS language source program consists of a sequence of symbolic machine instructions, pseudo 
instructions, and comment lines. With the exception of the comment lines, each statement consists of 
a location field, an operation field, a variable field, and a comments field. Each field is terminated by 
one or more blank characters. However, a blank embedded in a character data item, parenthesized 
macro parameter, or comments field does not terminate a field. The size of the variable field is re- 
stricted by the maximum statement size only. Statement format is essentially free field. 

Statements are 80-to-90-column lines. When punched on cards, each card is considered a line. A 
single statement may be composed of as many as ten lines. Information beyond column 72 is not 
interpreted by COMPASS but does appear on the assembly listing. Thus, columns 73-80 can be used 
for additional comments or sequencing. Columns 81-90 are used for sequencing by library maintenance 
programs; they are normally not used by the programmer. A line that contains two or more consecutive 
colons may be read and printed as two lines because of operating system conventions for delimiting line 
images. 

2.1.1 FIRST COLUMN 

The contents of column one designate the type of line, as follows: 

, (comma) Designates the line as a continuation of the previous line. 
*(asterisk) Designates the line as a comments line, 
other Indicates the beginning of a new statement. 

2.1.2 LOCATION FIELD 

The location field entry begins in column one or two of a new statement line and is terminated by a blank. 
If columns one and two are blank, the location field has no entry. A location field entry is usually 
optional. It may contain a symbol or name according to the requirements of the operation field, or a 
plus sign (+) or a minus sign (-) (section 3. 2. 4). 

2.1.3 OPERATION FIELD 

If the location field is blank, the operation field can begin in column three. If the location field is 
nonblank, the operation field begins with the first nonblank character following the location field and is 
terminated by one or more blanks. The operation field is blank if there are no nonblank characters 
between the location field and column 30. The following are legal field entries: 

Central processor unit mnemonic operation code and, optionally, the variable subfields with each 
variable subfield preceded by a comma. 

Peripheral processor unit mnemonic operation code 
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Pseudo instruction mnemonic operation code 
Macro name 



2.1.4 VARIABLE FIELD 



The contents of the operation field determine if any entry is required in the variable field which consists 
of one or more subfields separated by commas. The variable field begins with the first nonblank 
character following the operation field and is terminated by one or more blanks. It is blank if there are 
ablank characters between the operation field and column 30. 



UU UWUKJ L 



A variable subfield contains one of the following: 

Data it&Tcx 

Expression 

Register designator 

Name 

Special element 

Entry uniquely defined for the instruction 



2.1.5 COMMENTS FIELD 



Comments are optional and begin with the first nonblank character following the variable field or, if the 
variable field is missing, begin no earlier than column 30. The beginning comments column can be 
changed through the COL pseudo instruction (section 4. 4. 5). 

2.1.6 COMMENTS STATEMENT 

A comments statement is designated either by an asterisk in column 1 or by blanks in columns 1-29. 
Comments statements are listed in assembler output but have no other effect on assembly. A statement 
beginning with * is not counted in line counts for IF-skipping (section 4. 9) and definition operations 
(chapter 5) and is not included in definitions. A statement having columns 1-29 blank is counted. 

2.1.7 STATEMENT CONTINUATION 

Normally, column 72 terminates a source statement that has not yet terminated. However, a statement 
that cannot be contained in the first 72 characters can be continued on the next line by placing a comma 
in column one and continuing the field in column two. A maximum of nine continuation lines is permitted 
for a statement. The break between lines need not coincide with a field or subfield separator; even a 
symbol can be split between two lines. Continuation lines beyond the ninth, and continuation lines 
following a terminated statement are considered comment lines. 
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2.1.8 CODING CONVENTIONS 

Figure 2-1 illustrates a COMPASS coding form that establishes a coding convention as follows: 



Column 

1 

2-9 

10 

11-16 

17 

18-29 

30 



Contents 
Blank, asterisk.or comma 

Location field entry or plus, or minus ieit justuieu 
Blank 

Operation field entry left justified 
Blank 
Variable field entry left justified 



Beginning of comments 
All examples in this manual abide by this convention. 
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2.2 STATEMENT EDiTiNG 

COMPASS reads statements in sequence from the source file. It immediately edits and interprets each 
statement unless (1) it is a comments statement of the type indicated by an asterisk in column one, or 
(2) it is part of a definition, that is, it is a statement between a macro or OPDEF header and an ENDM, 
between a DUP or ECHO and an ENDD, or between an RMT pair. Statements within definitions are 
saved for editing and interpretation when the definition is referenced or expanded. Statements within 
the range of a conditional (IF type) pseudo instruction are edited even when they are skipped. COMPASS 
performs two types of editing: concatenation, and micro substitution. 

2.2.1 CONCATENATION 

COMPASS examines the statement for the concatenation character r-* and removes it from any field of 
the statement so that the two adjoining columns are linked. The most common use of the concatenation 
character is as a delimiter for a substitutable parameter name in a macro definition when there is no 
other type of delimiter already there to set off the parameter name. After the substitution takes 
place, the r~*is superfluous and is removed by editing before the definition is interpreted. 

Each removal of r~* shifts the remaining columns in the statement left one character. This could become 
significant when comments follow a blank variable field because the comments could be shifted left and 
interpreted as a variable field 

2.2.2 MICRO SUBSTITUTION 

COMPASS examines the statement for pairs of micro marks #) that delimit references to micro 
definitions (chapter 7 ) and replaces each reference (including the micro marks) with the micro character 
string referenced. The string that replaces the reference in the statement can be a different number of 
characters than the reference so that after the substitution, remaining characters in the statement are 
shifted left or right, accordingly. If, as a result of micro substitution, column 72 of the last card read 
is exceeded, the assembler creates up to a maximum of nine continuation cards, beyond which it 
discards excess without notification on the listing. No replacement takes place if the micro name is 
unknown or if one of the micro marks has been omitted. The micro marks and name remain in the line. 
In the first case, the assembler flags a non-fatal assembly error. However, a single micro mark is not 
illegal and does not produce an error flag. 

If the micro name is null (i. e. , the two micro marks are adjacent) both micro marks are deleted and no 
error fiag is set. 

The columnar displacement caused by a micro replacement could also affect the relationship of fields 
to the beginning comments column. For example, it could shift the operation or variable field right 
beyond column 30, or could shift comments left into a blank field. 

A line that contains two or more consecutive colons after editing may be printed as two lines because 
of operating system conventions for delimiting print lines. 
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2.3 NAMES 

A name is a sequence of characters that identifies one of the following: 
Subprogram or overlay 
Block 

Macro definition 
Remote definition 

Duplicated sequence (DUP or ECHO) 
IF sequence 
Micro 

A comma or a blank terminates a name. Concatenation marks and pairs of micro marks are removed 
before the name is scanned (see section 2. 2 Statement Editing). 

A CPU subprogram name or overlay name is used for linkage with other subprograms. It must begin 
with a letter (A-Z) and is limited to seven characters maximum. Conventions imposed on names by the 
operating system could restrict the use of certain characters in names. There is no restriction on the 
first character for a PPU subprogram or overlay name. For a 7600 PPU assembly, the name can be 
seven characters but for a 6000 Series assembly it is limited to three characters maximum. In all 
cases, the last character of a subprogram or overlay name cannot be a colon. 

Any other type of name can consist of one to eight characters. A name does not have a value or 
attributes and cannot be used in an expression. 

The different types of names do not conflict with each other. For example, a micro can have the same 
name as a macro, or a subprogram can have the same name as a block, etc. 
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2.4 SYMBOLS 

A symbol is a set of characters that identifies a value and its associated attributes. For an ordinary 
symbol, the first character cannot be a $ or = or a number; a symbol can be a maximum of eight 
characters. A symbol cannot include the following characters. 

+ - * / blank , A orf"* 

Other special characters must be used with care, especially in ECHO and macro definitions (chapter 5). 
Conventions imposed on symbols by the operating system could restrict the use of certain characters 
in symbols. 

An external or entry point symbol is used for linkage with other subprograms and has additional 
restrictions (section 2. 4. 1 Linkage Symbols). 

Concatenation marks or pairs of micro marks are removed before a symbol is examined (Section 2.2 
Statement Editing). In CPU assemblies, to avoid conflict with register designators, a symbol cannot 
normally be An, Bn, Xn, where n is a single digit from zero to seven nor can a symbol be A.x, B.x, 
or X.x, because x is assumed to be a data item by the assembler. However, symbols resembling 
register designators can be used if each use of the symbol is prefixed by =S or =X (Section 2.4. 2). 
Register designators are described further in Section 2.5. 

The process of associating a symbol with a value and attributes is known as symbol definition. This 
can occur in five major ways. 

1. A symbol used in the location field of a symbolic machine instruction or certain pseudo 
instructions is defined as an address having the current value of the location counter (section 
3. 2. 2) and having an attribute defined as follows: 

a. Absolute for the absolute block 

b. Common for labeled or blank common blocks (relocatable assemblies only) 

c. Relocatable for local blocks other than absolute during pass one. 

I d. Absolute for local blocks during pass two of an absolute assembly. 

2. A symbol used in the location field of definition pseudo instructions (section 4. 6) is defined as 
having the value and attributes derived from an expression in the variable subfield of the 
instruction. Certain of these pseudo instructions assign an attribute of redefinability to a 

I symbol. Unless a symbol is redefinable, a second attempt to define it with a different value 

produces a duplicate definition fatal error flag. 

3. An external symbol is defined outside the bounds of the current subprogram and is declared as 
external in the current subprogram or is defined in relation to a symbol declared as external. 
In either case it has the attribute of external. Unlike a systems symbol, the true value 
definition is not known to the current subprogram. 

4. Definitions of systems symbols that take place outside of the current program can be 
carried over to the current program through the SST pseudo instruction. COMPASS uses 
the true definitions but assigns the additional attribute of systems symbol. 
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5. COMPASS defines a symbol by default if a reference to a symbol is preceded by =S and the 
symbol is not otherwise defined in the subprogram. This feature is further described 
in section 2.4. 2 Default Symbols. 

There is no restriction on the number of times that the symbol can be referred to in the subprogram. 

Examples : 

Legal Symbols Illegal Symbols 

P 5A First character numeric 

R3 ABCDEFGHI Exceeds eight characters 

PROGRAM ABE+15 Contains plus sign 

=. 11 First character equal sign 

2.4.1 LINKAGE SYMBOLS 

A relocatable subprogram can be linked to other subprograms through linkage symbols. The two types 
of linkage symbols are external symbols and entry point symbols. An external or entry point symbol 
can be a maximum of seven characters, the first character must be a letter (A-Z), and the last 
character must not be a colon. 

Any symbol declared as an entry point in a subprogram compiled or assembled independently of the 
current subprogram can be declared as an external symbol in the current subprogram. Any symbol 
declared as an entry point in the current subprogram can be declared as an external symbol in some 
other subprogram. The symbol has a zero value and an attribute of external. An external symbol can 
be declared either through the EXT pseudo instruction or through default (a reference to the symbol is 
preceded by =X, see section 2. 4. 2 Default Symbols). 

External symbols can be defined in the subprogram relative to any external symbol declared in an EXT 
pseudo instruction. This is possible through use of symbol definition instructions that assign the value 
and attributes of an expression to a symbol. If the value of the expression reduces to an external 
symbol + an integer, the location field symbol is defined as having an integer value and external 
attribute. External symbols are not qualified (section 2. 4. 5). 

2.4.2 DEFAULT SYMBOLS 

When a symbol reference is preceded by =S or =X and the symbol is not defined in the subprogram, 
COMPASS defines the symbol or declares it as an external symbol, respectively, at the end of 
assembly. The =X form is defined by default in relocatable assemblies only. 

=Ssymbol If symbol is not defined, COMPASS assigns an address at the end of the zero 

block. All subsequent references to the symbol, whether preceded by =S or not, 
are to the location of the word. A default symbol cannot be used where a 
previously defined symbol is required. 

If the symbol is defined by a conventional method, COMPASS does not define it 
again but uses the programmer definition. 

=Xsymbol This option permits a programmer to define his symbols in a subroutine or link 

to them in another subprogram. If the programmer defines the symbol, the 
assembler uses the programmed definition. If the programmer does not define 
the symbol, the assembler assumes that the symbol is external as though declared 
in an EXT pseudo instruction. A symbol prefixed by =X must conform to the 
requirements for external symbols. 
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The system does not define a default symbol and issues an error flag if a symbol is prefixed by both 
=S and =X, or is prefixed by =X and is not defined conventionally in an absolute assembly. Default 
symbols are qualified by the qualifier in effect at the time of the =S reference. 

2.4.3 PREVIOUSLY DEFINED SYMBOLS 

Certain pseudo instructions require that a symbol in an expression be previously defined. This simply 
means that the symbol, before its use as an expression element, must be defined in a prior instruction. 

2.4.4 UNDEFINED SYMBOLS 

A reference to a symbol that is never defined (not even by default) causes a U error flag to be placed to 
the left of the instruction containing the erroneous reference. 

2.4.5 QUALIFIED SYMBOLS 

A symbol defined when a symbol qualifier is in effect during assembly (section 4.4.3) can be referred 
to outside of the qualifier sequence in which it was defined through: 

/qualifier/symbol 

The feature permits the same symbol to be defined in different subroutines without conflict. An 
unqualified symbol is global and does not require a qualifier when it is referenced, unless a qualifier 
is in effect, and a symbol qualified by the same qualifier has been defined. In this case, the unqualified 
symbol can be referenced as // symbol. 

The combination of qualifier and symbol permits a value to be identified by a unique 16-character 
identifier. Linkage symbols are not qualified. 

2.5 CPU REGISTERS 

Register designators symbolically represent the 24 CPU operating registers. These registers are 
described more fully in chapter 8. The designators are inherent to COMPASS and cannot be changed 
during assembly. 

In a CPU assembly, symbols of the same form as register designators may be used if each occurrence 
of such a symbol is prefixed by =S or =X (see section 2.4.2). However, a warning message is issued 
when such symbols are defined. The prefix cannot be used in the location field of machine instructions 
and symbol defining, data generating, BSS pseudo instructions, in the variable field of ENTRY, EXT, 
and SST pseudo instructions. 

Register Type Designator 

Address An or A.n 

Index Bn or B. n 

Operand XnorX. n 

For the forms An, Bn, or Xn, n is a single digit from to 7. Any other value for n, for example 8, causes 
An, Bn, or Xn to be interpreted as a symbol rather than a register designator. 
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For the forms A. n, B. n, X. n, n can be a symbol or an integer. If the value of n or the value of the 
symbol exceeds 7, the assembler truncates it to the least significant 3 bits and issues a warning flag. 

COMPASS does not recognize registers in PPU assemblies; there, the designators are acceptable as 
ordinary symbols. 

Examples : 



Al 

A10 

A.l 

A.NUM 
A. 10 



Designates address register 1 

Interpreted as a symbol, not a register 

Designates address register 1 

If the value of NUM is 6, it designates address register 6 

Designates address register 2; however, it produces a warning flag because the 
two was derived from the truncation of 12, the octal value for 10. 



The following produce equivalent results. A SET pseudo instruction (section 4. 6. 2) defines SUM and 
SUB as absolute values 3 and 2, respectively. A reference to a SET-defined symbol produces the same 
result as if the value had been used directly. In this example, the address of ALPHA is 001000. 



Code Generated 



6032001000 





LOCATION 


OPERATION 


VARIA8LE COMMENTS 


1 




II 


18 |30 








p 






SB3 


A2+ALPHA J 



3 

2 

6032001000 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 








I 




SUM 
SUB 


SET 
SET 
SB. SUM 


1 

3 1 
2 1 
A.SUB+ALPHA | 



2.6 SPECIAL ELEMENTS 

The following designators are reserved for use as references to special elements and cannot be used as 
symbols. The use of a special element in an expression causes the assembler to replace it with a 
value specified by the element in the expression. The control counters are discussed further in 
section 3. 2. 



Designator 



* or *L 



Significance 

The assembler uses the value of the location counter for 
the block in use. The element is relocatable unless the 
counter in use is for the absolute block. 



*o 



The assembler uses the value of the origin counter for the 
block in use. The element is relocatable unless the counter 
in use is for the absolute block. 



The assembler uses one less than the absolute value of the 
position counter for the block in use. 
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Designator Significance 

*P The assembler uses the absolute value of the 

position counter for the block in use. 

*F The assembler uses an absolute value obtained 

as follows: 

COMPASS was called by a COMPASS control 
card 

1 COMPASS was called by the FORTRAN RUN 
compiler 

2 COMPASS was called by the FORTRAN FTN 
compiler 

These designators are inherent to COMPASS and cannot be altered by the programmer during an 
assembly. 

2.7 DATA NOTATION 

Data notation provides a means of entering values for calculation, increment counts, operand values, 
line counts, control counter values, text for printing out messages, characters for forming symbols, etc. 

The two types of data notation are character and numeric. The assembler allows the user to introduce 
data in the program in three basic ways. 

Asa data item 

As a constant in an expression 

As a literal 

2.7.1 DATA ITEMS 

Character and numeric data items can be used in subfields of the DATA (section 4. 8. 2) and LIT 
(section 4. 8.4) pseudo instructions or as specifications of field lengths on VFDpseudo instructions. 

2.7.2 CONSTANTS 

A data constant is an expression element consisting of a value represented in octal, decimal, or 
character notation. It resembles a data item but is restricted by its use as an expression element in 
two ways: 

1. The first character must be numeric, prohibiting the delimited type of character string 
(section 2. 7.4) and the preradix for numeric values. 

2. The field size is determined by the destination field for an expression and can be a maximum 
of 60 bits thus prohibiting double precision floating point numbers. 



2-10 60279900A 



2.7.3 LITERALS 

A literal is a read-only constant. It is specified as a data item in a subfield of a LIT pseudo instruction 
or as an element in an expression. 

The method of specifying a literal in an address expression is nearly identical to that for specifying a 
data item in a DATA (section 4. 8. 2) or a LIT (section 4. 8. 4) pseudo instruction. The primary difference 
is that the literal is prefixed with an equal sign, which indicates that a literal follows. 

When a literal is used as an element in an expression, the expression is evaluated using the address of 
the literal in the literals block rather than the value of the data item. Thus, the literal is considered 
relocatable. (For a discussion of the literals block, see section 3. 1. 3). 

Conventionally, if a literal is used, it is the only element in an expression. 

The first use of a literal causes the assembler to assemble the data specified by the literal, and store 
the data in the literals block using as many words as are required to hold the data. If the binary pattern 
of the prefixed type of literal or of all the literals in a LIT declared sequence matches the binary 
pattern of words previously entered in the literals block, an entry is not generated for the 
data. This process eliminates duplication of read-only data. 

The LIT pseudo instruction permits symbols to be associated with literals block entries. Such entries 
can be referenced symbolically or through use of a prefixed literal. However, to preserve the integrity 
of the literals block, they should be used as read only locations. 

The assembly listing includes a list of the literals block when the D list option is selected (section 4. 11. 1). 

Example : 

In the following example, using CPU instructions, the first statement creates a word in the literals 
block having the value 00000000000000000001. The address of that entry (for the purpose of the 
example) is 5555 and is used in the address field of the two statements at address 100 and the state- 
ment at the lower part of 101. 

The literal in the second statement specifies a right justified character, A, which has a display code 
value of 1. The SB4 creates a one-word literal block entry having the value 00000000000000000002. 
The address of that entry is in the address field of statements at the upper half of addresses 101 
and 102. In this example, the LIT sequence duplicates a sequence of entries in the literals block 
and does not cause new entries to be assembled. 



Location 



100 



Code Generated 



6120005555 + 

6130005555 + 

101 61MJU05556 + 

5555 
6120005555 + 

102 6130005556 + 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




I 




M 


18 


1 30 








SB2 


= 1 










SB3 


=1RA 


' 








SBtf 


=1RB 


| 






L 


LIT 
SB2 
SB3 


1,2 

L 
L>1 


! 





CONTENT OF LITERALS BLOCK. 



005555 00000000000000000001 

005556 00000000000000000002 
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Continuing the previous example, a LIT sequence as illustrated below, does not duplicate a sequence in 
the literals block and causes entries to be generated in the literals block: 



Location 



Code Generated 



15557 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


|30 














LIT 


1,3,1R0,2 


1 
1 
1 



CONTENT OF LITERALS ELCCK. 



005555 00000000000000000001 

005556 00000000000000000002 

005557 00000000000000000001 

005560 00000000000000000003 

005561 00000000000000000004 
00556? 00000000000000000002 



A 
B 
A 
C 

B 



However, if the literals sequence in the first part of the example had been followed by a LIT that 
duplicates, in part, the most recent entries in the literals block, only the unduplicated part is added 
to the block. Thus, if the following LIT sequence had been used in place of the LIT 1, 3, 1RD, 2, the 
first two words of the sequence would match the last two words of the literals block so that only two 
additional words would be required to complete the sequence. 



Location 



Code Generated 



5555 



LOCATION 



OPERATION 



LIT 



VARIABLE 



COMMENTS 



I 30 



1,2,3,* 



CONTENT OF LITERALS BLOCK. 



005555 00000000000000000001 

005556 0000000000*0000000002 

005557 0O0OO0O000CflOOOOO003 
005560 OOOOOOOOOOOOOOOOOOO^ 



A 
B 
C 
D 
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2.7.4 CHARACTER DATA NOTATION 

Character data strings are converted to the code in use at the time the string is evaluated (section 4.4. 2, 
CODE pseudo instruction), and placed in a field indicated by the data type (data item, constant, or 
literal). When no ©ODE instruction has been issued, conversion is to display code representation. 



Format: 

Data Item 

Constant t 
Literalt 



sign 


n 


type 


string 



or 



sign 


type 


d 


string 


d 



n 


type 


string 










= 


sign 


n 


type 


string 




or 




= 


sign 


type 


d 


string 


d 



Example 
-3RABC 

-R*ABC* 

3RABC 

=-3RABC 

=-R*ABC* 



Applies to literals used as expression elements only; signifies that a literal follows. 

Sign Optional for data item or literal. A sign with a constant is interpreted as an element 
operator. 

+ or omitted The value is positive 

The complemented (negative) value is formed 

n Signifies how the string is determined: 



omitted 




The string is delimited by d. n cannot be omitted for a constant. 

For data item or literal, the string consists of all characters following 
type to : 

blank or , 

For a constant, string consists of all characters following type to: 

+ - * / blank , or A 

For a data item or literal, n is an integer count of the number of 
characters in the string not counting guaranteed zeros. It is limited 
only by statement size. 

For a constant, n is an integer count of the number of characters in the 
string. It cannot exceed 1/6 of the number of bits in the field that will 
contain the expression. A truncation error is flagged for a right 
justified constant if the most significant bit exceeds the field. Truncated 
zeros do not cause an error in this case. A truncation error is flagged 
for a left justified constant if the least significant bit positions are 
truncated, even if they are zero. 

The string consists of the n characters following type. 
Regardless of base, COMPASS assumes that n is decimal. 



t Expression element 
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type Character string justification. The characters formed by the data item 

or constant are right or left justified into the destination field as follows: 

Type Significance 

C Left justified with zero fill. For data item or 

literal, 12 zero bits are guaranteed at the end of 
the string even if another word must be allocated, 
for a constant, the zero bits are not guaranteed; C 
is the same as L. 

H Left justified with blank fill 

A Right justified with blank fill 

R Right justified with zero fill 

L Left justified with zero fill 

Z Left justified with zero fill. For data item or 

literal, six zero bits are guaranteed at the end of 
the string even if another word must be allocated. 
For a constant, the bits are not guaranteed; Z is 
the same as L. 

d A delimiting character used only when n is omitted. The characters 

between the first occurrence of d and the second occurrence of d 
comprise the string, d can be any character other than r-»or ^. 

string Characters from one of the COMPASS character sets (appendix D), 

except for those characters that act as delimiters (see n and d), the 
concatenation character ( p* ), and pairs of micro marks ft). 

Concatenation marks and pairs of micro marks are removed by 
editing before a string is examined. A single micro mark can be 
used in a string. 

An empty or omitted character string is defined under one of the 
following conditions. 

1. n is and type is immediately followed by a delimiter (for 
example, OL. ) 

2. n is omitted and the two delimiting characters are concurrent 
(for example, H++) 

Omission of a string in a DATA pseudo instruction is legal and does 
not cause generation of a data word. 

For a constant, an omission of the string is valid and has a zero value. 

An omitted string in a LIT pseudo instruction is legal and does not cause 
generation of a literal for that item; however, the LIT must contain at 
least one non-empty data item. 

An omitted string for a literal in an expression is not legal and produces 
an error. 

It is not possible to generate empty strings using types C, Z, R or A. 
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Examples of character- data: 

In these examples, characters are converted to display code representation; all lines of code 
generated by DATA are printed only if the D or G list option is selected. 

Data Items 



Location 



Code Generated 



14«f 05222217225511165520 
1«»5 0^215500000000000000 
H»6 55555555555555555555 



LOCATION 



OPERATION 



II 



DATA 



VARIABLE 



COMMENTS 



I 30 



L*ERR0R IN PDQ »,L..,1QH 



Location 



Code Generated 



1100 


1725 


1101 


2«»20 


1102 


252* 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


i 




II 


18 1 30 






PPU 
DATA 


0LOUTPUT J 



Constants 



Location 



Code Generated 



<f722 71300000<*7 

k7Z3 71«t0000060 

i 

k72W 6260530000 
*»725 0155555531 
<»726 2^00000001 



5110031117 



11172<t0155 



17252^2025 



0700000000 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 






SX3 


1R» [ 




TAG 


SXJf 


1Ri».*1 | 






SA1 


3RCI0 i 






SB6 


X0+1LS i 






VFU 


3Q/«»HIorA,6/iRA,2<»/0AX + l 






VFO 


*t2/0LOUTPUT,18/l 






WF0 


15/0LG,15/0L| 



Note that the character constant in the expression in the second line consists of a decimal point 
(57 in display code) to which 01 is added before the value is stored. Similarly, in the third field 
of the first VFD, 1 is added to the display code representation of X right justified with blank fill 
(55555530) so that 55555531 is generated. 
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Literals 



Location 



Code Generated 



100003765 

100003770 

2652 5110003772 + 

5120003771* + 

2653 5130003767 + 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ho 




TAG1 


LIT 
LIT 

SAl 
SA2 

SA3 


RA+-*/(A,6L> t= ,.,0C0,0L 

20HLITERALS 

=0CTENCHARCTS 

=H*LEFT JUSTIFY WITH BLANKS* 

= 0L0 



CONTENT CF LITERALS BLOCK. 



003765 
003766 
003767 
003770 
003771 
003772 
003773 
003771* 
003775 
003776 



0000000 
525351*5 
33000 00 
1«»112U0 
5555555 
2«*05160 
0000000 
11*05062 
063155? 
011613? 



0001*51*61*75051 
5565700000000 
0000000000000 
5220111*235555 
5555555555555 
31001220321*23 
0000000000000 
1*5512252321*11 
7ll?i*1055021i* 
3555555555555 



+ -*/( 
>$= ,. 


LITERALS 

TENCHARCTS 

LEFT JUSTI 
FY WITH BL 
ANKS 



The first LIT pseudo instruction generates three words in the literals block; the 0L item is an empty 
string and does not produce an entry. The second LIT pseudo instruction generates one two-word 
entry. The expressions in the variable fields of the SAl, SA2, and SA3 instructions each consist of a 
literal element. The character strings in the SAl and SA2 literals do not duplicate former literals 
block entries so COMPASS generates new entries. However, since SA3 references an existing entry, 
COMPASS places the address of the entry in the address field of the instruction. 
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2.7.5 NUMERIC DATA NOTATION 

Numeric data can be specified in octal or decimal notation. The value is converted to an integer or a 
floating point value in single or double precision. 

Formats : 



Data Item 

Constant 

Literal 



sign 


pre radix 


value 


modifiers 



value 


modifiers 



= sign 


preradix 1 value 


modifiers 



sign 



preradix 



value 



Applies to literals only; signifies that a literal follows. 

Optional for data item or literal; a sign with a constant is interpreted as an element 
operator. 

+ or omitted The value is positive 

The complemented (negative) value is formed 

Optional for data items and literals; cannot be used for constants. The preradix 
indicates the notation used for the value. 



omitted 



Bor O 
D 



Notation can be specified by a postradix modifier or can be 
assumed from the assembly base. See BASE pseudo instruction. 

Octal notation 

Decimal notation 



A series of octal or decimal digits optionally consisting of an integer, a decimal (or 
octal) point, and a fraction. An integer value (fixed point) does not contain a point. 
A floating point value (legal in CPU assemblies only) is noted by the occurrence of 
the point. 

An octal value can be a maximum of 20 significant digits (fixed point) or 32 significant 
digits (floating point). An octal value cannot include 8 or 9. A decimal value cannot 
exceed 1. 15 x 10 18 (fixed point) or 7. 9 x 1028 (floating point, ignoring the decimal 
point). Extra significant digits cause erroneous results. 

If value is omitted, it is assumed to be zero. 
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modifiers Associated with the value are the following optional modifiers specified in any sequence. 
A specific type of modifier can be specified only once. A duplicate produces an error 
flag. 



postradix 
decimal exponent 



binary scale. 



binary point 
position 



Indicates the notation used for the value. See preradix for legal values. 
An error is flagged if notation contains both a preradix and a postradix. 

Defines a power of 10 scale factor 

E+n or En or E Single precision 

EE+n or EEn or EE Double precision 

When the sign is plus or is omitted, the exponent (n) is positive. 

When n is omitted, it is assumed to be 0. The value of n cannot exceed 
32767 and is always assumed to be a decimal integer. 

A fixed point value can be single precision (one word) only but a CPU 
floating point value can be generated in double precision (two words). 

If EE is used with a fixed point value, the assembler produces a fixed point 
number in single precision. 

The effect of the exponent is to multiply the value by 10 decimal raised 
to the n power. 

Defines a power of two scale factor and is specified as follows: 
S+n or Sn or S 

When the sign is plus or is omitted, the scale factor (n) is positive. When 
n is omitted, it is assumed to be 0. The value of n cannot exceed 32767 
and is always assumed to be a decimal integer. 

The effect of the binary scale is to multiply the value by 2 raised to the 
n power. 

Applies to floating point values only and is specified as follows: 

P+n or Pn or P 

When the sign is + or omitted, n indicates the number of bit positions 
the point is to be shifted to the left of bit 0. When the sign is -, n 
indicates the number of bits the point is to be shifted to the right. 

The effect of P is to align the value so that the binary point occurs to the 
right of the n bit. 

The exponent is adjusted to a value of - (+n) 

For example, a value with P-6 will have a biased exponent of 2006 fi ; a 
value with P10 will have an exponent of 1765 Q . 

o 

If P is not specified for a floating point number or if n is omitted, the 
assembler generates a normalized floating point value. The P modifier 
permits generation of an unnormalized value. 

If, as a result of P, the most significant bit of the value is shifted out of 
the coefficient part of the single or double precision number, the assembler 
generates an overflow or underflow error. 



2-18 



60279900D 



Although scale factors can exceed valid ranges, the ranges for numbers are restricted 
by the hardware. 



Example : 



38 



The number 1. 0E4000S-1200 yields a number that is approximately 5. 8 x 10 
and is in range of the floating point representation. 

All calculations are performed in 144-bit precision. The values are rounded to 96 
bits for double precision and to 48 bits for single precision floating point numbers and 
to 60 bits for integers. 

The order in which the assembler acts on the modifiers, regardless of the sequence 
in which they are specified is: 

1. Decimal exponent (single or double) 

2. Binary scaling 

3. Binary point position (CPU assemblies only) 



CPU Numeric Data Items 
Location Code Generated 

5000 777777777777777777^?. 

5001 i7235oononoooononnoo 

5002 16 k3 0000000 00000000 

5003 20000000000000000012 
500^ 17760000000000000002 

5005 1715«*6517676355^26<4 

5006 1720031<4631<t631«»631i* 

5007 77777777777777777777 
5010 00000000000000000000 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ! 30 








1 




POOL 


DATA 


-29 




NUH 


DATA 


1.0EE1 . 






DATA 


1.0F+1P0 I 






DATA 


3.2P1S-5E1 






DATA 


Q.0151E+01 1 






DATA 


0.1P«t7,-E,DEES 

I 



CPU Numeric Constants 



Location 



Code Generated 



5001 + 
555 



5012 
5112 



20360 



<f3760 



7150«»00000 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


30 




ALPHA 


EQU 


P00L+1 






VAL 


EQU 

PSSZ 

LX3 

MX7 

SX5 


555B 
100B 
-1<*R 

1S17 
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CPU Numeric Literals 



Location 



Code Generated 



5113 515O0Q5151 + 

5130005152 
5153 
5155 
5156 
5157 





LOCATION 


\ 

OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ho 








SA5 


=2 0<*6755000 23«tflOOQO<»B 








SA3 


=1.1 1 






ABLE 


LIT 
LIT 
LIT 

LIT 


l.OEEl 1 

0.1Pi»7 

-019 1 

0.0151E+01,-£,OEES 





CONTFM OF LITERALS BLOCK. 

005151 200%675500023*»OOOOOi» PDa Bl 

005152 1720i»31«»631<»631»i6315 OPULILILIM 

005153 17235300008800000000 OS/ 
00515«» 164*30000000000000000 N8 
005155 172003i'»631«»631<»631i* OPCL»L»LtL 
05156 7777777777777777775«i ;;?;;;;;?= 
005157 1715«»6517676355<»«»26<» 0H-<""" , 2=7* 

005160 77777777777777777777 ?;;??;;??? 

005161 OOOOOOOOOOOOOOOOOOOO 



Examples of numeric data (assume default radix is decimal): 



PPU Data Items 



Location 



Code Generated 



300 


0005 


301 


7766 


302 


0013 


303 


0030 


30«i 


0002 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


i 




II 


18 ho 






PPU 

• 
• 
• 

OATA 


1 

1 

: i 
i 

5,-90,*B13,lUBSl,2»»BE-l 

i 
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PPU Constants 



Location 


Code Generated 


305 


0000 


306 


0011 


307 


<»«»«»3 




31 




101 



310 



7777 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


ie 


30 






CON 


0,+H 








CON 


-33 3«« 






ARC 


= 


?5D 






NLM 


SET 
CON 


0101 
7777 





PPU Literals 




Location 


Code, Generated 


311 


5000 1103 


313 


5100 110<» 


315 


5000 1105 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


i 




II 


18 ho 






LOM 
AD* 
LDH 


= 10D 

= -l ! 
=7777 I 



CCNTFNT OF LITFRALS PLCCK. 



1103 
110<f 
1105 



0012 
7776 
7777 



»»»»»»♦»» 



;; 
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2.8 EXPRESSIONS 

Entries in subfields of most source statements are interpreted as expressions consisting of a 
combination of one or more terms. Each-term consists of one or more elements joined by operators. 
A comma or a blank terminates the expression. 

An expression element can be a: 



Symbol 




Numeric or character constant 


Special element 




Register designator (CPU only) 


Literal 




mples of elements: 




ALPHA 


A. 7 


$ 


X3 


*P 


77BS3 



3HABC 
=10HOUTPUT 



A term can be a single element or two or more elements joined by the following element operators: 

* Multiplication 
/ Division 

An expression can be a single term or two or more terms joined by the following term operators : 

+ Addition 

Subtraction 
A Logical minus 



Rules: 



1. If the last element of a term is omitted, COMPASS provides an element of zero. For example, 
if ABLE is a symbol, ABLE*+3 is interpreted as the value of ABLE times plus 3. 

2. Two successive elements are illegal. Note, however, that ** is legal because the first asterisk 
is interpreted as an element, the second asterisk is interpreted as an operator, and the blank is 
interpreted as a null element. 

3. A term can contain one relocatable or external element only. Thus, **ABLE, where ABLE is a 
relocatable address, is illegal because ABLE and * are both relocatable. 

4. The element to the left of a divisor must be absolute. 

5. Division by zero results in zero with no error. 

6. Two or more additive operators (+ or - or A ) in sequence are interpreted as having a term of 
zero value between them. 

7. If an expression begins with an additive operator (+ or - or A )» COMPASS provides a term 
with zero value preceding the operator. 
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The operator that immediately precedes a register designator is the register operator, regardless 
of the placement of the designator in the expression. The register operator can be: 

+ - * or / 

Examples of expressions: 

ABLE Single term 

t-29 Two terms; $ and 29 

l*=3.1*»J.59EE+6 Two terms; a constant and the address of a literal. COMPASS places the 
literal in the literal block and uses its address in the expression. 

•+3 Two terms; value of the location counter and numeric constant 3. 

ABLE*4-7.2/NUM Two terms, each consisting of two elements; the value of ABLE times 4, 

and 72 divided by the value of NUM. 

10 B Single term consisting of a numeric constant. 

3*A6-NUM The components of the expression are register A6 and 3-NUM. 

1R=*1R/ The character constants (= and/) are logically differenced. 

2.8.1 TYPES OF EXPRESSIONS 

Evaluation during assembly reduces an expression to: 

An absolute value (absolute address or an integer value) 
An external symbol + a 21 -bit integer 
+ relocatable value + a 21 -bit integer 
Register designators and one of the above 
Register designators 

Absolute Expressions 

An expression is absolute if its value is unaffected by program relocation. An expression can be 
absolute, even though it contains relocatable terms, under these two conditions: 

1. The expression contains an even number of relocatable elements 

2. The relocatable elements must cancel each other. That is, each relocatable element (or 
multiple thereof) in a block must be canceled by another element (or multiple thereof) in the 
same block. In other words, pairs of elements in the same block must have signs that oppose 
each other. The elements that form a pair need not be contiguous in the expression. 

Examples of absolute expressions: 

In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. 
The control counters are for the block that contains EASY and FOX. 



CPU assembly only 
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EASY-FOX+MIKE EASY and FOX cancel each other. 

PO X-» FOX and tne location counter cancel each other. 

HIKE+16 The expression contains no relocatable elements. 

EASY -FOX *2+» EASY and the location counter cancel 2 times FOX. 

Relocatable Expressions 

An expression is relocatable if its value is affected by program relocation. A relocatable expression 
consists of a single relocatable term or, under these two conditions, a combination of relocatable and 
absolute terms: 

1. The expression does not contain an even number of relocatable elements 

2. All the relocatable elements but one must be organized in pairs that cancel each other. That is, 
for all but one block, each relocatable element (or multiple thereof) in a block must be canceled 
by another element (or multiple thereof) in the same block. The elements that form a pair 
need not be contiguous in the expression. 

3. The uncanceled element can have three kinds of relocation: 

a. Positive program 

b. Negative program 

c. Positive common (negative common is not permitted by the loaders) 

Examples of relocatable expressions: 

In the following examples, EASY and FOX are relocatable in the same block. MIKE is absolute. 
LIMA is relocatable in a different block. The control counters are for the block that contains 
EASY and FOX. 

LIMA+MIKE-16 

FOX-EASY+FOX 

3»F0X-2»EASY 

EASY-»*FOX 

FOX-100B/MIKE 

-MIKE»2*LIMA 

=10HMESSAGE 33 

-*0 



The pairing of relocatable terms cancels the effect of relocation because both terms would be relocated 
by the same amount. The comparative value of the two terms remains the same regardless of program 
relocation. 
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External Expressions 

An expression is external if its value depends upon the value of a symbol defined outside of the current 
subprogram. Either an external expression consists of a single positive external term or under the 
following conditions an external expression may consist of an external term, relocatable terms, and 
absolute terms. 

1. The expression contains an even number of relocatable terms. 

2. The relocatable elements must cancel each other. That is, each relocatable element ( or 
multiple thereof) in a block must be canceled by another element (or multiple thereof) in the 
same block. In other words, pairs of elements in the same block must have signs that oppose 
each other. The elements that form a pair need not be contiguous in the expression. 

Examples of external expressions: 

In the following examples, XYZ and ABC are external symbols. EASY and FOX are in the same 
block. The control counters are for the block that contains LIMA. MIKE is absolute. 

XYZ-*+FOX-EASY+LIMA The pairs * and LIMA, and FOX and EASY cancel each other. 

F0X-3*EASY+2*F0X+XYZ The relocatable elements all cancel. 

ABC+100B 

XVZ+ABC Illegal; both are external 

-ABC*»-LIMA Illegal; ABC is negative 

XYZ+*0 Illegal; *0 is an unpaired relocatable element 

Register Expressions 

An expression is a register expression if, in a CPU assembly, it reduces to one or more register 
designators and an operand. The attributes of the operand can be that of an absolute, external, or 
relocatable expression. Use of register expressions is generally restricted to symbolic CPU 
machine instructions (section 8. 4). If the register designator is the first element in the expression, 
the operator can be omitted and is assumed to be +. 

Examples of register expressions: 

In the following examples, XYZ is an external symbol and LIMA is a relocatable symbol. 

X3+LIMA-10B 

LIMA+X3-10B \ Produce identical results 



-10B+LIMA+X3 

Bi+XYZ 

•+A.NUM 



) 
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Evaluatable Expressions 

An evaluatable expression is an expression that does not contain any symbols as yet undefined. Certain 
pseudo instructions require that the expressions be evaluatable. 

2.8.2 EVALUATION OF EXPRESSIONS 

When evaluating an expression, COMPASS replaces each element with a 60-bit value. A character 
constant is first right or left adjusted in a field the size of the destination field and then extended to 
60 bits. Signs are extended for 21 -bit quantities, that is, for counters, addresses, and symbols. In 
division, the integral portion of the quotient is retained; any remainder is discarded. Thus, 5/2*2 
results in 4. 

COMPASS forms a term value by interpreting each element and operator from left to right until it 
reaches a + or - or a operator. It then notes whether or not the newly formed term contains a 
relocatable or external symbol or register designators. The value of the symbol is added, subtracted, 
or differenced from the cumulative sum of the absolute elements, relocatable elements, or external 
values. The assembler continues evaluating the expression until it is reduced to a symbol and/or a 
value. An error is flagged if the expression cannot be reduced. The expression value is truncated, if 
necessary, and placed in the destination field. If it is too large for the field, the system issues an 
error flag. The maximum field size for an expression is 60 bits. 

The value of an external symbol is zero if the external symbol is defined outside of the subprogram. 
It is the value relative to the external used in defining the symbol if the external symbol was defined 
within the subprogram. 

A zero value is used in place of a register designator. 

For pass one evaluation, the system uses the value of a relocatable symbol relative to the block in 
which the symbol was defined. For pass two evaluation, the system uses a value relative to program 
or common block origin. 

The field size for an expression depends upon the instruction and is determined as follows: 

1. For a symbol definition pseudo instruction, the expression value (including character 
constants) is justified in a 21 -bit field. 

2. In a VFD pseudo instruction, the expression is placed in a field of the size specified. 

3. For a CON pseudo instruction, the field size is one word (12 bits for PPU assemblies, 
60 bits for CPU assemblies). 

4. In a symbolic machine instruction, values of expressions are placed in address fields (18 or 
6 bits for CPU assemblies; 18, 12, or 6 bits for PPU assemblies). 

Some relocatable program loaders may give unexpected results if relocatable or external address 
values are assembled into the same field of the same word more than once, as a result of ORGing 
backward over the word, or by having more than one subprogram preset a common block. 
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PROGRAM STRUCTURE 



This chapter describes the general structure of a program. In some cases, it repeats information 
described elsewhere and correlates it so that the programmer will obtain a better understanding of how 
the program is assembled, loaded, and executed. Some mention is made of the SCOPE loader, but 
for a complete description of the loader, refer to the reference manual for the operating system or 
loader in use. 

The first topic considered in this chapter is the subprogram block and how the assembler and the 
programmer organize the object code into blocks. Following this is a brief description of the counters 
that control the blocks. 

Finally, there is a summary of the differences in the structure of absolute and relocatable programs 
and the effect of these differences on block usage. 

3.1 SUBPROGRAM BLOCKS 

A subprogram, whether assembled as absolute or relocatable, can be divided into subprogram areas 
called blocks. As nssembly of a subprogram proceeds, the assembler or the user designates that 
object code be generated or that storage be reserved in specific blocks. By properly assigning code 
sequences, data, or reserved storage areas to blocks through use of ORG and USE pseudo instructions, 
a programmer can intersperse instructions for the different blocks. The assembler assigns locations 
in a block consecutively as it encounters instructions destined for the block. A symbol defined within 
a block is not local to the block. That is, it is global and can be referred to from any other block in 
the subprogram. To render a symbol local to a sequence of code requires use of the QUAL pseudo 
instruction (section 4. 4. 3). 

Blocks established between two IDENT instructions, or between an IDENT and END, form a group of 
blocks. COMPASS recognizes a maximum of 255 blocks in a single block group, 252 of which can be 
user-established. When COMPASS interprets an TDENT or END pseudo instruction, it begins pass two 
processing of the completed block group. 

All symbols are assigned absolute values, the table of block names is cleared, the list of USE and ORG 
instructions is cleared, and block structuring restarts. For END, the symbol table is cleared before the 
next subprogram is assembled. If the group does not contain a USE instruction or if object code is 
generated (or storage reserved) before the first USE instruction, COMPASS places the code in the nominal 
block (identified as PROGRAM* on the listing). For an absolute program, the nominal block is the 
absolute block. For a relocatable program, the nominal block is the zero block. The user controls use 
of the nominal block and any user-established blocks through USE and ORG pseudo instructions (section 
4. 5). Each occurrence of a non-redundant literal constant causes an entry in the literals block; 
otherwise, the user has no control of this block. 
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3.1.1 ABSOLUTE BLOCK 

The absolute block is the nominal block for an absolute assembly. It is identified by the name PROGRAM* 
on the listing. All code generated in the block is absolute. Each address symbol is defined during pass 
one as an absolute value relative to zero which is block origin. The code generated must be loaded and 
executed at the origin specified as the absolute block origin. 

Normally, a relocatable assembly does not contain an absolute block. It may have one established, 
however, if the programmer issues an ORG request using an absolute value. The assembler generates 
text tables specifying absolute block relocation. The loader loads the absolute text when it encounters 
the text table, without manipulating any addresses. For a relocatable assembly, an absolute block is 
identified on the assembly listing by the name ABSOLUTE*. 

3.1.2 ZERO BLOCK 

The zero block has the block name and is the nominal block for a relocatable assembly. It is a local 
block; that is, it is not accessible to other subprograms. Upon completion of assembly, the assembler 
assigns any undefined default symbols at the end of the zero block. The zero block is identified by the 
name PROGRAM* on the assembler listing. 

An absolute program has a zero block only if the program contains default symbols. In an absolute 
assembly, the zero block immediately follows the absolute PROGRAM* block. 

3.1.3 LITERALS BLOCK 

COMPASS generates literal data entries in the literals block. It is local to a subprogram. The literals 
block is identified by the name LITERALS* on the assembly listing. 

3.1.4 USER-ESTABLISHED LOCAL BLOCKS 

By using USE statements, a programmer can establish local blocks in addition to those previously 
described for an absolute or relocatable subprogram. At the end of assembly, COMPASS assigns an 
origin relative to the nominal block to each user-established local block, in the sequence in which they 
are established. 



3.1.5 LABELED COMMON BLOCKS 

A labeled common block is a storage area that can be preset with data accessible to one or more 
relocatable subprograms. These blocks are designated during assembly as being in 7600 SCM 
or 6000 CM through the USE f pseudo instruction where the name of the block is the name enclosed 
by slant bars i. e. ,/name/. The tables are designed so that the loader can allocate space in 
memory for the first subprogram that is loaded that declares the block. Thus, the first subprogram 
that names a block sets the maximum size of the block. Each subprogram, as it is loaded, can 
link to allocated blocks or can cause new blocks to be allocated. The contents of a labeled common 
block can be generated by any of the subprograms having access to it. 

If an absolute subprogram attempts to establish a labeled common block by using a USE/name/ 
instruction, COMPASS treats the block as a local block having the slant-bar enclosed name. 



t7600 COMPASS Version 2 allows presetting of data in LCM through the USELCM /name/ 
instruction (section 4. 5. 2). 
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3.1.6 BLANK COMMON BLOCKS 

A blank common block is a storage area that cannot be preset with data. That is, the loader does not 
load information into the area before the program is executed. 

For a relocatable program, the blank common block is allocated 7600 SCM space or 6000 CM space by 
the SCOPE relocatable loader after all subprograms are loaded, according to the largest block area 
declared by any of the subprograms. The blank common block is established through a USE pseudo 
instruction (section 4. 5. 1); it has no name; a USE // indicates blank common. 

If no relocatable subprogram declares a blank common block, there is none. If an absolute program 
contains a USE // instruction, COMPASS treats the block as a local block named // and data can be 
stored in this block. 

Only a CPU program can use the USELCM pseudo instruction to establish named 7600 LCM or 6000 
ECS blank common blocks. These blocks provide a means of symbolically addressing the job's 
LCM or ECS field from a CPU program. In pass one, COMPASS assigns addresses in each block 
starting with zero (RAL). At the end of assembly, COMPASS assigns an origin relative to zero 
to each common block, in the sequence in which they are established. No code can be assigned to 
the blocks; they can be used for storage reservation only. It is the responsibility of the user to 
assure that sufficient LCM or ECS is scheduled on the job card to accommodate the blocks when the 
program is executed. (For use of the LCM or ECS blocks refer to the USELCM pseudo instruction, 
section 4. 5. 2). 

3.2 BLOCK CONTROL COUNTERS 

For each block used in a subprogram, COMPASS maintains three counters, an origin counter, a location 
counter, and a position counter. When a block is first established or its use is resumed, COMPASS uses 
the counters for that block. During pass one, the origin and location counters are initially zero. During 
pass two, as the assembler constructs the program, it assigns an initial value to each local block origin 
counter and location counter. Thus, expressions containing relocatable symbols are not necessarily 
evaluated the same in pass one and pass two. 

3.2.1 ORIGIN COUNTER 

The origin counter controls the relative location of the next word to be assembled or reserved in the 
block. It is possible to reserve blank storage areas simply by using either the ORG or BSS pseudo 
instructions to advance the origin counter; ORG also permits the programmer to reset the counter to 
some lower location in the block or to change blocks. BSS allows the programmer to decrement the 
counter but not to change blocks. The origin counter is incremented by one for each word assembled 
or skipped forward and decremented by one for each word skipped in the reverse direction. 

When the special element *0 is used in an expression, the assembler replaces it by the current value of 
the origin counter for the block in use. 
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3.2.2 LOCATION COUNTER 

The location counter is normally the same value as the origin counter and is used by the assembler for 
defining symbolic addresses within the block. The counter is incremented whenever the origin counter 
is incremented. It is possible through the LOC pseudo instruction to adjust the location counter so that 
it differs from the origin counter. This may be desirable when the code being assembled is to be 
loaded at one location and subsequently moved and executed at another location. In this case, the 
programmer resets the location counter to reflect the actual location at which execution is to occur. 
As another example of its use, the programmer assembling a large table may reset the location counter 
to zero so that on the listing, the addresses alongside each word of the table reflect the word's position 
in the table rather than in the block. Note that use of this technique does not alter the placement of code 
in the block. (For an example of these applications, see the LOC pseudo instruction, section 4, 5. 5. ) 
When either of the special elements * or *L is used in an expression, the assembler replaces it by the 
current value of the location counter for the block in use. 

3.2.3 POSITION COUNTER 

Assume that bits are numbered 59-00, from left to right within a 60-bit CPU word and numbered 11-00 
within a 12-bit PPU word. Then, the position counter is initially 60 and 12, respectively, and indicates 
the number of bits remaining in the word. The position counter, which is decremented by one for each 
completed bit of an assembled word, becomes 00 when the word is completed, and is reset to 60 or 12 
when a new operation is started. 

For a CPU assembly, the 15-bit and 30-bit CPU instructions cause the position counter to normally 
have values of 60, 45, 30, and 15 reflecting the placement in the word for the next instruction or 
data word to be generated. For a PPU assembly, the normal value is 12. 

The normal pattern of advancement for the position counter can be altered through use of the VFD and 
POS pseudo instructions. 

When the special element *P is used in an expression, the assembler replaces it with the current 
value of the position counter. 

When the special element $ is used in an expression, the assembler replaces it with the current value 
minus one of the position counter for the block in use; that is, it returns the next available bit position. 

3.2.4 FORCING UPPER 

In a CPU assembly, if any of the following conditions is true, the assembler packs parcels remaining 
in a partially completed word with no-operation instructions (section 8. 1), sets the position counter to 
60, and increments the origin and location counters before it assembles code for the next instruction: 

Insufficient room remains in a partially filled word for the next instruction or data to be generated 

The current statement contains a symbolic address or + in the location field and the location field is 
not ignored 

The next symbolic instruction to be assembled is a 6000 Series RE, WE, PS, or XJ instruction. 
(The programmer can negate this force upper by placing a minus sign in the location field of the 
instruction. ) 

The current pseudo instruction is END, BSS, BSSZ, DATA, DIS, CON, SEGMENT, SEG or IDENT. 
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The assembler forces upper after it assembles code for one of the following: 

JP 

RJ 

Unconditional EQ 

Unconditional ZR 

ES (7600 only) 

MJ (7600 only) 

PS (6000 Series only) 

XJ (6000 Series only) 

This post force upper is not done immediately, but is deferred until the next machine instruction or 
data generating, storage allocating, or binary control pseudo instruction in the same USE block is en- 
countered. The programmer can negate the force upper following the instruction by placing a minus 
sign in the location field of the next instruction. Thus, pseudo instructions following one of the above 
machine instructions and referencing the origin, location, or position counter will use the value before 
the force upper. 

In a PPU assembly, no forcing upper occurs; the assembler ignores a + in the location field on any 
instruction other than a VFD. A plus or minus in the location field of a VFD in PPU assemblies forces 
the VFD. data to begin at the next full word. 

3.3 RELOCATABLE PROGRAM STRUCTURE 

A CPU relocatable program consists of one or more subprograms that can be assembled separately, 
either in the same computer run or in independent runs. The subprogram can all be written in 
COMPASS source language, or can be written in any other source language available in the product set 
of the operating system as long as the compiler or assembler produces relocatable binary output in a 
form acceptable to the SCOPE loader. A COMPASS language subprogram is composed of instructions 
beginning with an IDKNT pseudo instruction and ending with an END pseudo instruction. 

The COMPASS assembler repertoire includes pseudo instructions that facilitate relocatable subprogram 
linkage. Through these linkages, subprograms loaded together can transfer control to each other and 
can access common storage locations. 

Upon completion of assembly of a relocatable subprogram, COMPASS assigns each local block an origin 
relative to the zero block (figure 3-1). Output is in the form of tables for the SCOPE Relocatable 
loader (appendix B). Each local block thus becomes an extension of the zero block. The length of the 
subprogram given on the assembly listing is the sum of the final values of the origin counters for the 
local blocks, including the zero block and literals block, but not the absolute block. Any absolute text 
is simply inserted at the absolute location relative to RAS (or RA). 
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Loaded Program 
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Subprogram 1 



Figure 3-1. Relocatable Program Structure 



3-6 



60279900A 



3.4 ABSOLUTE PROGRAM STRUCTURE 

An absolute program consists of code that is not relocatable and must be loaded at specific core 
locations. Because the absolute loader performs no address manipulation, absolute code can be 
loaded more rapidly than relocatable code. 

The programmer has the option of constructing his absolute program as a single unit, or of dividing 
it into overlays. Each overlay consists of data, information, or instructions that are needed at 
different times. Dividing a program into overlays allows several routines to occupy the same core 
storage consecutively so that total storage requirements for a program are reduced. 

During assembly of an absolute program or overlay, COMPASS creates a core image of the absolute 
code. During pass two, it assigns each block an origin relative to the absolute block. Any relocatable 
symbol is reassigned an absolute address; each block effectively becomes an extension of the absolute 
block. Figure 3-2 illustrates the structure of an absolute program that is not divided into overlays. 

The binary output for the program consists of a record for each overlay. Note that the record for an 
absolute program that is not divided into overlays has the same format as the main overlay of a program 
divided into overlays. The user has the option of writing part of a binary record at a time by using 
either a SEG pseudo instruction or an IDENT (other than the first IDENT) with a blank variable field. 

An absolute record has three parts : 

1. 77 _ prefix table 

2. 50 g or 51 g overlay table, or a 6000 or 7600 PPU header table 

3. Core image of the program 

Record format is described more fully in appendix B. 

The amount of binary written as a result of the binary control instruction (IDENT, SEGMENT, SEG, or 
END) is subject to whether or not an entire block group is written. 

If a complete block group is being written (everything between an IDENT and an END or between 
two IDENT instructions), the core image of the program or overlay ends with the maximum origin 
counter value for the last block established, that is, with the last word address. 

If only a portion of the binary for the block group is being written, it consists of the core image of 
the program or overlay ending with the value of the current origin counter. 

END, SEGMENT, and a nonblank IDENT complete a record and write an end of record. SEGMENT and 
IDENT write header information for the overlay to follow. 
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3.4.1 ABSOLUTE OVERLAYS 

When an absolute program contains more than the one IDENTt pseudo instruction or contains SEGMENT 
pseudo instructions, COMPASS does not prepare just one record of a core image of the program as it is 
assembled, but, instead, generates a record for each overlay. 

Dividing the program into overlays permits core to be sequentially overlayed by different subroutines 
and data during program execution, reducing the maximum core requirements for the program. 

For a CPU assembly, the overlay generated is either primary or secondary as determined by the 
IDENT or SEGMENT pseudo instruction. The portion of the program following the first IDENT is 
normally the main overlay and is identified by the level numbers 0, 0. Secondary overlays can be 
generated subsequent to the main overlay. A secondary overlay is identified by the level numbers 
x,y, where x is nonzero. 

Conventionally, the main overlay is the first one loaded and contains calls to the operating system 
loader to load one or more overlays as they are required during object time execution. Any overlay 
can call the loader to load another overlay. Control transfers to an entry in the overlay or returns 
to the calling overlay according to the format of the call. (For detailed information concerning CPU 
loader calls, refer to the operating system reference manual. ) 

Because overlays are not all in core concurrently during program execution and because the sequence 
in which overlays are loaded and executed is beyond the scope of the assembler, it is the user's 
responsibility to assure that an overlay does not refer to symbols, instructions, or data that is not 
concurrently in core. 

Although PPU overlays are not identified by level numbers, they resemble CPU overlays in all other 
respects. 

Overlays generated by using IDENT pseudo instructions differ in certain respects from overlays 
generated by using SEGMENT instructions, as described below. 

Binary formats for overlays are described in appendix B. 

IDENT- Type Overlays 

The portions of the program from IDENT to IDENT, and IDENT to END comprise the overlays. IDENT 
provides the programmer with the option of specifying the overlay level numbers with each overlay, 
including the overlay generated by the first IDENT. 

If no level number is provided for a CPU assembly, the first overlay is numbered 0, and any overlay 
after that is numbered 1,0. IDENT allows each overlay to be assigned unique numbers. Thus, the 
loader has a means of locating a specified overlay when several overlays are written on the same file. 



t IDENT instructions discussed in this section are assumed to have nonblank parameters. The special 
case of the blank IDENT is described in section 3. 4. 3. 
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The first IDENT causes COMPASS to generate the program or overlay identification information 
(appendix B) that precedes the absolute record. Upon encountering a second IDENT instruction before 
an END instruction, COMPASS generates output consisting of a core image of the overlay starting with 
the overlay origin specified on the previous IDENT and normally ending with the maximum origin 
counter value of the last block declared in the overlay, that is, it normally ends with the last word 
address. An IDENT subsequent to a SEG or SEGMENT, however, generates binary that ends at the 
location specified by the current origin counter. Following the core image, COMPASS writes an end 
of record and the overlay identification information specified by the new IDENT for the overlay to follow. 

For an IDENT-type overlay, COMPASS completes all blocks, including the literals block. Block 
structuring starts fresh with each overlay. This means that each overlay can use the same block names 
used by other overlays, and each overlay can contain a literals block. The USE table and control 
counters are all reinitialized. The origin specified for an IDENT-type of overlay can be any place in a 
previously generated overlay. This is possible because IDENT causes the assembler to assign an 
absolute address to each symbol in the symbol table. It can do this because the sizes of all the blocks 
are known. 

Figure 3-3 illustrates a CPU program consisting of a main overlay and a secondary overlay. The main 
overlay uses the absolute block and block A. Default symbols and literals cause the assembler to 
generate a zero block and the literals block. Following the second nonblank IDENT instruction, the 
program overlay origin is set back into the block A. The overlay generates a new literals block 
and new blocks A, C, and D. 
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SEGMENT-Type Overlays 

The portions of the program from the IDENT that identifies the program to SEGMENT, from SEGMENT 
to SEGMENT, and from SEGMENT to END comprise the overlays. SEGMENT does not provide for 
unique numbering of overlays. The first overlay has the identifier 0,0. All subsequent overlays are 
numbered 1,0, 

Upon encountering a SEGMENT instruction, COMPASS generates output consisting of a core image of 
the overlay starting with the overlay origin specified on the previous SEGMENT (or IDENT, for the 
first overlay), and ending with the current origin counter value of the block in use at the time the 
SEGMENT was encountered. Following this, COMPASS writes an end-of-record and overlay identi- 
fication information for the overlay to follow. 

For SEGMENT, the last block used in the overlay is incomplete. If the overlay contains literals, it 
must have a user-established block as the block in use when the SEGMENT is encountered. A PPU 
overlay cannot contain literals. For a CPU assembly, the literals block is in the overlay that 
contains the end of the absolute block. It is the responsibility of the user to assure that all blocks 
other than the one in use are complete. The origin of the new overlay can be defined using symbols in 
the block in use only. SEGMENT does not clear the symbol table or reinitialize the USE table. 

Each new SEGMENT- created overlay must use unique block names because blocks established in 
previous overlays cannot be resumed and because the block names remain in the USE table due to the 
incompleteness of the block group. 

Figure 3-4 illustrates a program consisting of a main overlay and a secondary overlay. The main 
overlay uses the absolute block, the literals block, and block A. Default symbols cause the generation 
of a zero block. Following the SEGMENT, an ORG instruction sets the overlay origin back into block A, 
the block in use when the SEGMENT was encountered. The 1,0 overlay establishes new blocks C 
and D. 
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3.4.2 MULTIPLE ENTRY POINT OVERLAYS 

When a CPU program or overlay that calls an overlay is assembled independently of the overlay called, 
it may be desirable for the called overlay to identify more than one entry point. Thus, ENTRY pseudo 
instructions are permitted within an absolute assembly and cause the generation of a 51g overlay 
table. This table consists of a control word and a list of overlay entry points. The calling program can 
examine the list and link to any of the entry points. The 51s table occupies the area below the overlay 
origin and uses one more word than the number of entries in the table. For the format of the 51 „ table 
refer to appendix B. 

Overlays of this type cannot be created or loaded by the 6000 SCOPE loader. 

3.4.3 PARTIAL BINARY 

When a CPU absolute program or an overlay contains SEG pseudo instructions or IDENT pseudo 
instructions for which the parameters are omitted (blank), COMPASS writes a partial binary record 
consisting of the binary generated since the previous IDENT, SEGMENT, or SEG instruction. However, 
it does not write an end of record or a new 77 table. A SEGMENT, nonblank IDENT, or END 
instruction completes the binary record. 

SEG-Type Partial Binary 

By writing partial binary using SEG, the programmer can reduce the assembler storage requirements. 
A fatal error is issued if the user attempts to store data into a block previously written out or into a 
block that will be written out later. 

When the SEG is encountered, COMPASS writes binary beginning with the first block established in 
that portion of binary and ending with the final count specified by the origin count for the current block. 

SEG does not write a complete block group. The portion of the binary that contains the end of the 
absolute block contains the literals block, if there is one. The symbol table and USE table are not 
reinitialized. 

Figure 3-5 illustrates how the binary for an absolute program can be written in three separate binary 
writes to reduce the amount of core required to assemble the program. The resulting absolute record 
is loaded and executed as a single program or overlay. 
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Figure 3-5. SEG-Type Partial Binary 



IDENT-Type Partial Binary 



An IDENT with a blank variable field causes all binary accumulated since the previous IDENT, SEG, 
or SEGMENT to be written out without an end of record or a new 77s prefix table. The USE table 
and the block counters are reinitialized. Each symbol in the symbol table is assigned an absolute 
address. The blocks in each partial binary generated in this manner are allocated as if the section 
were a new subprogram with its own absolute block, literals block, and local blocks. This allows 
portions of a program to be self-contained units even though they are not overlays but are loaded as 
a single unit. The origin of an absolute block for a new portion is the last word address plus one of the 
last block of the previous portion. 

The core image written by a blank IDENT starts with the origin of the absolute block and normally ends 
with the maximum origin counter value of the last block declared in the block group, that is, it normally 
ends with the last word address. If part of the block group has already been written by a SEG or 
SEGMENT, however, the end of the binary is specified by the value of the origin counter for the current 
block. 



60279900A 



3-15 



COMPASS completes all blocks. The literals block is terminated. Block structuring starts fresh with 
each section. Each new section created by a blank IDENT can use the same block names as are used 
by the other section of IDENT-created overlays and each section can contain a literals block but the 
blocks with the same names are independent of each other. 

An attempt to write into or to reset the origin counter to a location in a section written separately 
causes a range error. 

Figure 3-6 illustrates how the binary for an overlay can be written in three discrete sections to reduce 
the amount of core required to assemble the program and divide the program into self-contained units. 
The resulting absolute record is loaded and executed as a single overlay. 
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PSEUDO INSTRUCTIONS 



4.1 INTRODUCTION TO PSEUDO INSTRUCTIONS 

This chapter and chapters 5, 6, and 7 describe the pseudo instructions available in the COMPASS 
language. It is impossible to write a program in the COMPASS language without using some of the 
more basic pseudo instructions. The programmer who is new to the language should give special 
attention to these instructions: 



Pseudo 


Instruction 


Section 
4.2.1 


CPU Relocatable 
X 


CPU Absolute 
X 


PPU Absolute 


IDENT 




X 


ABS 




4.3.1 




- 


X 


_ 


PPU or 


PERIPH 


4. 3. 2 or 


4.3.3 


- 


- 


X 


ORG 




4.5.3 




- 


X 


X 


ENTRY 




4.7.1 




X 


- 


- 


BSS 




4.5.4 




X 


X 


X 


CON 




4.8.6 




X 


X 


X 


END 




4.2.2 




X 


X 


X 



4.1.1 TYPES OF PSEUDO INSTRUCTIONS 

Pseudo instructions discussed in this chapter are classed according to application as follows: 

Subprogram identification (IDENT and END) 

Binary control (ABS, PERIPH, PPU, IDENT, SEGMENT, SEG, LCC, STEXT, COMMENT, and 
NOLABEL) 

Mode control (BASE, CODE, COL, Bl=l, B7=l, and QUA L) 

Block counter control (USE, USELCM, ORG, BSS, LOC, and POS) 

Symbol definition (EQU and =, SET, MAX, MIN, MICCNT, and SST) 

Subprogram linkage (ENTRY and EXT) 

Data generation (BSSZ and blank operation code, DATA, DIS, LIT, VFD, CON, R=, REP and REPI) 

Assembly control (ELSE, ENDIF, IFCP and IFPP, IFop, IF, IFC, and SKD?) 

Error control (ERR and ERRxx) 

Listing control (LIST, EJECT, SPACE, TITLE, TTL, NOREF, CTEXT, ENDX, and XREF) 

Later chapters describe pseudo instructions that involve definition operations, alterations to the 
operation code table, and micros. In general, pseudo instructions can be summarized according to 
where they can be placed in a subprogram. 
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4.1.2 REQUIRED PSEUDO INSTRUCTIONS 

Two pseudo instructions, IDENT and END, are required for any assembly. IDENT must be the first 
source statement; END signals the termination of source statements for a subprogram. 

4.1.3 FIRST STATEMENT GROUP 

Certain pseudo instructions establish basic characteristics of the assembly and provide the assembler 
with required information. These instructions comprise the first statement group which must precede 
any symbol definition, storage allocation, or object code generation. The following instructions, if used, 
must be in the first statement group. 

ABS 
PERIPH 
PPU 
STEXT 

4.1.4 PERMISSIBLE ANYWHERE INSTRUCTIONS 

The following pseudo instructions are permissible anywhere, including in the first statement group. 



BASE 


DECMIC 


HERE 


MICRO 


PPOP 


SST 


Bl=l 


EJECT 


IFC 


NIL 


PURGDEF 


TITLE 


B7=l 


ELSE 


IRP 


NOLABEL 


PURGMAC 


TTL 


CODE 


END 


LIST 


NOREF 


QUAL 


XREF 


COMMENT ENDD 


MACRO 


OCTMIC 


RMT 




CPOP 


END1F 


MACROE 


OPDEF 


SKIP 




CPSYN 


ENDM 


MICCNT 


OPSYN 


SPACE 





Comments lines and references to macro definitions are also permitted anywhere. 

CPU or PPU symbolic machine instructions and all other pseudo instructions cannot be placed in the 
first statement group. The first use of one of these instructions terminates the first statement group. 

4.2 SUBPROGRAM IDENTIFICATION 

Subprogram identification pseudo instructions designate subprogram beginning and end. When two or 
more subprograms are assembled in a single COMPASS run called through COMPASS control card, 
the end of the source decks is indicated by an end-of-record card (7-8-9 punches in column 1). 

4.2.1 IDENT - SUBPROGRAM IDENTIFICATION 

An IDENT pseudo instruction of the following form is the first statement of a subprogram recognized 
by the assembler. Usually, any lines preceding the first IDENT or between an END and IDENT are 
assumed to be comments. However, when COMPASS has been called by some other language processor 
such as FORTRAN, the assembler returns control to the processor when the statement following END 
is not IDENT. For a relocatable subprogram COMPASS flags any subsequent use of IDENT before 
END as an error. For an absolute subprogram, a second form of IDENT described under BINARY 
CONTROL is available for overlay generation. 



4-2 



60279900D 



The format of IDENT varies according to the type of assembly. 
CPU Relocatable Format: 



LOCATION 



OPERATION 



IDENT 



VARIABLE SUBFIELDS 



name 



CPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBflElDS 




IDENT 


name, origin, entry, ^ , 1 2 



7600 PPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name , origin , entry , ppu 



6000 Series PPU Absolute Format: 



LOCATION 



OPERATION 



IDENT 



VARIABLE SUBFIELDS 



name, origin 



name 



origin 



Name of the subprogram or overlay. The parameter is required. For a CPU 
relocatable or absolute assembly, name can be 1-7 characters, of 
which the first must be alphabetic (A-Z) and the last must not be a colon. 

For a 7600 PPU assembly, name can be 1-7 characters. For a 6000-Series 
PPU assembly, name can be 1-3 characters. In either case, there is no 
restriction on the first character, but the last character must not be a colon. 

An expression specifying me first word address of the absolute program or 
overlay. The overlay loader table and all code assembled starting at this 
address and ending with the next SEGMENT, nonblank IDENT, or END 
instruction comprises the overlay. For a single entry point CPU program 
the load address for the record is origin-1. The word at origin -1 is over- 
layed by the 50 loader control table. For a multiple entry point CPU program, 
the load address for the absolute record is origin^wc-1, where wc is the 

number of entry points in the 51 loader table. 

8 



For a PPU subprogram, the load address is origin-5. 
are overlayed by the 60-bit loader table. 



Five 12-bit PPU words 



Data can be generated in locations starting with origin and above, but not below 
origin. The origin subfield does not serve the same function as ORG nor does 
it replace ORG for setting the origin counter. 
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If the origin field is null for an absolute subprogram, the assembler uses 
address 000000 (RAS) as the origin for a CPU program and 0000 as the 
origin for a PPU program. 

For a relocatable subprogram, the subfield is ignored. The loader automatically 
relocates the first subprogram to be loaded starting at RAS+100g, the second 
subprogram starting at the first available location following the first subprogram, 
etc. 



entry 



For a 7600 PPU assembly or an absolute CPU assembly, this subfield contains 
an expression specifying the subprogram entry address, which can be symbolic. 



h'h 



Absolute expressions specifying the level numbers of the overlay, j^ is the 
primary level (0-63) and & is the secondary level (0-63). When the first IDENT 
identifies the main overlay, ^ and i 2 can be omitted. If i x is omitted, it is set 
to 00. If j£ 2 is omitted, it is set to 00. 

Because the first IDENT precedes any use of the BASE pseudo instruction, the 
level numbers on this IDENT are evaluated as decimal unless specifically 
designated as octal by a post radix. 



ppu 



Absolute expression specifying the number of the PPU on which this program is 
to be loaded. On the first IDENT, this number is evaluated as decimal unless 
specifically designated as octal. 



A location field symbol, if present, is ignored. 

If the COMPASS assembler is called from within a FORTRAN compilation rather than by a COMPASS 
control card, IDENT must be in columns 11-15. 

When the subprogram does not include a TITLE instruction, COMPASS uses the IDENT variable field 
entry as the main subprogram title on the assembly listing. 

Example : 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 












CONTROL 


IDENT 

RBS 

ORG 

BSS 

END 


CT, CONTROL, CONTROL 

IABSOLUTE CPU PROGRAM 
HOB | 
DEFINES SYMBOL CONTROL 



Absolute CPU program CT will be loaded at origin address 00110 



8 



4-4 



60279900A 



4.2.2 END - END OF SUBPROGRAM 

An END pseudo instruction must be the last instruction of each subprogram. It causes the assembler to 
terminate all counters, conditional assembly, macro generation, or code duplication. Before terminating 
assembly, COMPASS assembles any waiting remote text (see RMT). 

For a relocatable subprogram, the assembler combines all local blocks into a relocatable subprogram 
block, generates the relocatable binary tables (appendix B), and produces the listing. 

For an absolute assembly, the assembler assigns each block an origin relative to absolute zero, 
combines all blocks into an absolute subprogram or overlay, generates the absolute binary record and 
produces the listing. 

END can also be used to signal the end of source statements from an external source (see XTEXT). In 
this case, it does not terminate the subprogram. 

Format: 



LOCATION 



sym 



OPERATION 



END 



VARIABLE SUBFIELOS 



trasym 



sym 



Optional last word address symbol; if present, COMPASS defines it as the 
total subprogram length, including the literals block and all local blocks. 
The value is the last word address plus one. 



trasym 



A symbol specifying the entry point to which control transfers for a reloca- 
table subprogram. This symbol must be declared as an entry point in a 
subprogram ~ not necessarily the subprogram being assembled. At least 
one subprogram must specify a transfer address or the loader signals an 
error. If more than one. subprogram indicates a transfer address, the loader 
uses the last one encountered. 



Example: 



For an absolute assembly, trasym is ignored. 



LOCATION 



BFGIN 



OPERATION 



IDENT 
ENTRY 



SB1 



END 



VARIABLE 



COMMENTS 



| 30 



PROGi 
BEGIN 



BEGIN 
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4.3 BINARY CONTROL 

Pseudo instructions that allow the user extensive control of binary output produced by the assembler are 
summarized below and described fully in this section. 

ABS Specifies CPU absolute binary output 

PPU Specifies 7600 PPU binary output 

PERIPH Specifies 6000 Series PPU binary output 

IDENT Begins absolute overlay or writes partial binary record 

SEGMENT Begins absolute overlay 

SEG Writes partial binary record 

STEXT Generates systems text overlay 

COMMENT Inserts comments into the 77 „ prefix table 

o 

NOLABEL Suppresses header information on binary output 

LCC Passes loader control information to the relocatable loader 



4.3.1 ABS -ABSOLUTE CPU PROGRAM 

An ABS instruction declares a CPU program to be absolute. If used, it must be in the first statement 
group. Refer to appendix B for a description of the binary format. 

The following instructions are illegal in an absolute program: 

EXT 
LCC 
REP 
RE PI 



A symbol can be prefixed by =X if it is also defined conventionally; in this case, the =X has 
significance because a conventional definition takes precedence (section 2. 4. 2). 
Format : 



no 



LOCATION 



OPERATION 



ABS 



VARIABLE SUBFIEIDS 



Symbols in the location and variable fields, if present, are ignored. If a program contains both ABS 
and PERIPH (or PPU), the PERIPH (or PPU) instruction takes precedence. 
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Example : 



LOCATION 



OPERATION 



VARIABLE 



COMMENTS 



130 



CT, CONTROL, doNTROL 

(ABSOLUTE CPU PROGRAM 



CONTROL 



IOENT 
ABS 



ORG 
BSS 



END 



HOB 





t, 



EFINES SYMBOL CONTROL 



4.3.2 PPU - 7600 PPU PROGRAM 

A PPU instruction declares a program to be a 7600 absolute PPU program rather than a CPU program. 
If used, PPU must be in the first statement group. For a description of binary format generated as 
a result of this instruction, refer to appendix B. 

Floating point constants and the following instructions are illegal in a PPU assembly: 



ENTRY 

EXT 

LCC 

REP 

REPI 

SEG 



SEGMENT 

USELCM 

R= 

Bl=l 

B7=l 



If the program contains both a PPU and a PERIPH pseudo instruction, the PPU takes precedence. PPU 
programs permit symbols of the form used for CPU register designators; they are normal symbols 
having no special significance. The following instructions are legal but are not applicable in a PPU 
assembly: 

OPDEF 
CPOP 
CPSYN 
PURGDEF 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




PPU 


J 



A character string beginning with J supplied in the variable field alters the way 
that COMPASS assembles the variable expression on UJN, ZJN, NJN, MJN, or 
or PJN instructions. 
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If J is not specified, COMPASS first tests the range of the expression against 
the short jump limit (+31). If the value is in range, COMPASS assembles the 
jump using the value of the expression. If the value is out of range, COMPASS 
performs a second test, this time using the expression value minus the 
location counter value. If the value is now in range, COMPASS assembles the 
instruction using the expression value minus the location counter value. 
However, if it is out of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the 
location counter from the value of the expression. 

As a result, COMPASS is able to differentiate between an expression value 
that is an absolute address in the short jump range from an expression value 
that is a true relative address. 



A symbol in the location field, if present, is ignored. 
Example: 



Location 


Code Generated 

0357 
Code Generated 

357 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 






i 




II 


18 


1 30 




7kQ 

760 




TAG 


PPU 

• 
• 

BSS 
UJN 


20B 
TAG-' 


1 . 

1 
1 
1 

| EXPRESSION 1 < 
I 


77B 


Location 




LOCATION 


OPERATION 


VARIABLE 


COMMENTS 






i 




II 


18 


Uo 




7<*0 
760 




TAG 


PPU 

• 
• 

BSS 
UJN 


JUMP 

20B 
TAG 


f- 

1 
1 

IEXPRESSION-* 


< 37R 



4.3.3 PERIPH - 6000 SERIES PPU PROGRAM 

A PERIPH instruction declares a program to be a 6000 Series absolute PPU program rather than a CPU 
program. If used, PERIPH must be in the first statement group. For a description of binary output 
produced as a result of this instruction, see appendix B. 

Floating point constants and the following instructions are illegal in a PPU assembly: 



ENTRY 


USELCM 


EXT 


R= 


LCC 


Bl=l 


REP 


B7=l 


REPI 




SEG 





A symbol can be prefixed by =X if it is also defined conventionally. 
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PPU programs permit symbols of the form used for CPU register designators; they are normal 
symbols having no special significance. The following instructions are legal but are not applicable 
to PPU assemblies: 

OPDEF 
CPOP 
CPSYN 
PURGDEF 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




PERIPH 


J 



J A character string beginning with J supplied in the variable field alters the 

way that COMPASS assembles the variable field expression on UJN, ZJN, 
MJN, or PJN instructions. 

If J is not specified, COMPASS first tests the range of the expression value 
against the short jump limit (+.31). If the value is in range, COMPASS assembles 
the jump using the value of the expression. If the value is out of range, COMPASS 
performs a second test, this time using the expression value minus the location 
counter value. If the value is now in range, COMPASS assembles the instruction 
using the expression value minus the location counter value. However, if it is out 
of range, a fatal error is flagged. 

Selection of the J option causes COMPASS to always subtract the value of the 
location counter from the value of the expression. 

For an example illustrating how to use J, see the PPU pseudo instruction. 

A symbol in the location field, if present, is ignored. 

4.3.4 IDENT - IDENTIFY AND GENERATE OVERLAY 

Two or more IDENT pseudo instructions are permitted in CPU absolute or PPU assemblies. Second 
and subsequent IDENT instructions having nonblank variable fields cause generation of overlays. IDENT 
differs from SEGMENT in the way it generates overlays. First, it allows the specification of overlay 
numbers. Second, the USE table and all block counters are reinitialized. The symbol table is not 
cleared; all symbols are reassigned absolute addresses relative to absolute zero. Thus, an ORG to a 
previously defined symbol restarts the absolute block at the symbolic address. The third difference is 
that normally the end of the overlay is determined by the last word address, the maximum origin 
counter value of the last block established in the overlay. A preceding SEG or SEGMENT can alter 
this, however (see section 3.4). 
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For a CPU assembly, an IDENT with a blank variable field causes a partial binary write. The 
output is not terminated by an end of record or a new 778 table. However, the USE table and the 
block counters are reinitialized and each symbol in the symbol table is assigned an absolute address. 

Following an IDENT, COMPASS assumes that all blocks, including the literals block are complete. 
Block structuring starts fresh with the new overlay or portion of binary. Thus, each new overlay or 
partial can use the same block names as are used by other overlays or partial and each can have a 
literals block. 

For a blank IDENT, an attempt to write into or reset the origin counter to a location in a section 
written separately causes a range error. Following the IDENT, the origin of the new absolute block 
is the next word after the binary written out, that is, it is lwa+1. 

The format of the IDENT varies according to the type of assembly as follows: 

CPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name , origin, entry, ^ , f 



or 



LOCATION 



IDENT 



7600 PPU Absolute Format: 



OPERATION 



VARIABLE SUBFIELDS 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name , origin, entry , ppu 



6000 Series PPU Absolute Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IDENT 


name , origin 



name 



Name of the overlay. For a CPU program, 1-7 characters, the first of which 
must be alphabetic (A-Z); for a 6000 Series PPU program, 1-3 characters; for 
a 7600 PPU program, 1-7 characters, in all cases, the last character must not 
be a colon. A name is a loader linkage symbol required for overlays. 
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origin 



An expression specifying the first word address of the overlay. The overlay 
control word and all code assembled starting with this address and ending with 
the next SEGMENT, nonblank IDENT, or END instruction comprises the overlay. 
For a single entry point CPU program, the load address for the overlay is 
origin-1. The word at origin-1 is overlayed by the 50 loader table. For a 
multiple entry point CPU program, the load address for the overlay is origin- 
wc-1, where wc is the number of entry points listed in the 51s loader table 
(appendix B). 



For a PPU subprogram, the load address is origin-5. Five 12-bit PPU words 
are overlayed by the 60-bit loader control table. Data can be generated in 
locations starting with origin and above, but not below origin. The origin 
subfield does not serve the same function as ORG nor does it replace ORG for 
setting the origin counter. The origin of an overlay can be below the origin 
specified on any other IDENT or SEGMENT. 



entry 



An expression specifying the overlay entry address, 
called, control optionally transfers to this address. 



When the overlay is 



*1»*2 



Absolute expressions specifying the level numbers of the overlay for CPU 
programs only. ^ is the primary level (00-77 g ), jf 2 is the secondary level 
(00-77 g ). if base is M, ^ and £ 2 are assumed to be octal. If jjj and £ 2 are not 
specified, ^ is set to 01 and £ 2 is set to 00. 



ppu 



An absolute expression specifying the number of the PPU in which the overlay 
is to be loaded. If base is M, ppu is assumed to be octal. 



A location field symbol, if present, is ignored. 

The binary is written on the file specified by the B parameter on the COMPASS control card. END 
dumps the last overlay or completes a partially written record. Refer to appendix B for file formats. 
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Examples: 



The following program uses IDENT for overlay creation. Symbols T.OVL, 0. DMP1, etc. are 
defined on a system text overlay. 



DfM 



LOCATION 



DMP 



JRW2 



OPERATION 



IDENT 

ABS 

BASE 

COMMENT 

LIST 

SST 

ORG 

OUAL 

SXO 



QUAL 
IDENT 
ORG 
SXO 



OUAL 
IDENT 
ORG 
SXO 



END 



COMMENTS 



DMP. 1, T.OVL, 

M 

10/07/70. C 



T.OVL 

DMPl 

Bl 



DMP? 

DMP2,T.OVL,0 
T.OVL 
B6 + 1 



DMP9 

DMP. 9, T.OVL, 

T.OVL 

0.0MP2+F.MDE 



0.DMP1 



ONTROL CARO CALL. DMP. 



.OMP2 



0.DMP9 



kND OVERLAY DMP9 



OVERLAY 
DMP1 



OVERLAYS DMP2 
THROUGH DMP8 



J 



OVERLAY 
0MP9 
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The following program uses IDENT instructions having blank variable fields. 



1617 



3i»55 



7116 



FNT 



OPERATION 



I9ENT 
ABS 
ORG 
?X0 



LIT 



TOENT 



LIT 



IOFNT 



LIT 



FNO 



VARIABLE 



COMMENTS 



I 30 



VVV,II0B,ENT 
10O 



»2»? 



,3 



1,2 



First 
Partial Binary 



1 



Second 
Partial Binary 



Third 
Partial Binary 



J 



Origin ~* 


ABSOLUTE 


1617 ~* 


LITERALS 




Local Blocks 




ABSOLUTE' 


3455 — 


LITERALS' 




ABSOLUTE" 


7116 — 


LITERALS" 


lwa — ► 


Local Blocks 



First 
Partial Binary 

J 

1 

Second 

Partial Binary 

j 
1 

Third 
Partial Binary 

J 



Core Map 
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4.3.5 SEGMENT - GENERATE BINARY SEGMENT 

The SEGMENT pseudo instruction produces overlays at assembly time. It has many of the features of 
IDENT and is included primarily to maintain compatibility with previous versions of 6000 COMPASS 
and to provide another way of handling literals. Use of SEGMENT is intended for CPU absolute or 
6000 Series PPU assemblies. It is illegal for 7600 PPU assemblies. For a relocatable subprogram, 
a SEGMENT pseudo instruction causes BSSZ code and the FILL, REPL, and LINK relocatable tables 
to be written on the binary output file. 

The first SEGMENT causes all binary accumulated since the IDENT to be dumped as the main (0,0) 
overlay. Each subsequent SEGMENT generates a new overlay identified by the level 1,0. END dumps 
the last overlay. Refer to appendix B for overlay record format. When COMPASS encounters a 
SEGMENT pseudo instruction, it does not clear the symbol table or block declarations. All blocks 
other than the block in use must be complete. For a CPU assembly, the literals block must be in one 
overlay only but that overlay can be any overlay. 

Format: 



LOCATION 



name 



name 



OPERATION 



SEGMENT 



VABIABIE SUBFIEIDS 



origin, entry 



Name of overlay. For a CPU program, 1-7 characters, first of which must be 
alphabetic (A-Z); for a PPU subprogram, 1-3 characters. In all cases, the last 
character must not be a colon. It is a required loader linkage symbol. 



origin 



A relocatable expression specifying the first word address of the overlay. It 
can only be an address in the block in use. The overlay loader table and all 
code assembled starting at this address and ending with the next SEGMENT, 
nonblank IDENT, or END instruction comprises the overlay. 



For a CPU program the load address for the record is origin-1. 
at origin-1 is overlayed by the 50g loader table. 



The word 



For a PPU subprogram, the load address is origin-5. Five 12-bit PPU 
words are overlayed by the 60-bit loader table. Data can be generated in 
locations starting with origin and above, but not below origin. The origin 
subfield does not serve the same function as ORG nor does it replace ORG 
for setting the origin counter. The origin of an overlay can be below the 
origin specified on any other IDENT or SEGMENT. 



entry 



An expression specifying the overlay entry address. It is used for CPU 
assemblies only. When the overlay is called, control optionally transfers 
to this address. 
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Example: 



LOCATION 



ENTft 



OVLOC 



SEG1 



STRT 



ENTB 



OPERATION 



II 



VARIABLE 



COMMENTS 



IDENT 
ABS 

ORG 

ess 



BSS 



SEGMEN 
ORG 
BSS 
BSS 



BSS 



END 



SAM,ENTA 
HOB 



STRT, ENTB 
OVLOC 
1 




30 



ENTRY POINT 



OVERLAY LOAD POINT 



LOADER TABLE 

FIRST WORO OF OVERLAY 



EXECUTION BEGINS HERE 



END OF OVERLAY 



SEG1 is loaded as an overlay upon a call for the loader from the program. The first word of the overlay 
is loaded at OVLOC +1, following the loader table. The entry point to the overlay and the first executable 
instruction is at ENTB. The overlay, when executed occupies the area of the main program beginning 
at OVLOC. 

4.3.6 SEG - WRITE PARTIAL BINARY 

The SEG pseudo instruction permits the generation of a CPU absolute subprogram or overlay in less core 
than would otherwise be required for assembly. It is illegal in PPU and relocatable assemblies. 

SEG causes COMPASS to write on the binary output file all binary information accumulated since the 

previous IDENT, SEGMENT, or SEG pseudo instruction. It does not write an end of record or begin 

a new 77 prefix table. A SEGMENT, IDENT, or END instruction completes the binary record. 
8 

SEG does not affect the location and origin counters. The user cannot resume use of a block established 
prior to the SEG, except for the block in use when the SEG was encountered. An attempt to reset the 
origin counter so as to resume a block already written out causes an R error. Also, since the block 
group is incomplete and the names of the blocks already written out are still in the USE table, no new 
blocks can be established using the same block names as were used prior to the SEG. 

The literals block is written in the portion that contains the end of the absolute block. 

See also, section 3.4.3 Partial Binary. 
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Format: 



LOCATION 



OPERATION 



SEG 



VARIABLE SUBFIELDS 



Symbols in the location field and variable field, if present, are ignored. 
Example : 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ho 














IDENT 

ABS 

USE 

• 
• 
• 

SEG 
USE 

• 
• 

SEG 

• 
• 
• 

END 


NAME, ORIGIN, ENTRY 
A | 

• 

• | 

8 | 

• • 

• 

• | 

• 
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4.3.7 STEXT - GENERATE SYSTEMS TEXT RECORD 

As a result of an STEXT pseudo instruction, binary output for the subprogram consists of all symbols, 
program macros, opdefs, and micros written in overlay format at the end of pass one. The STEXT 
instruction must be in the first statement group. 

The systems text record becomes available in other assemblies through use of the S c*<Toption on 
the COMPASS control card (chapter 10). Through this feature, information on the systems text record 
need be processed only once for all COMPASS programs using the same system text record. 

System text records cannot be generated and used in the same assembly batch; system text records 
generated by one COMPASS control card call can be used only by assemblies performed by later 
COMPASS control card calls. 

The symbols included in the system text record written are all symbols defined in the assembly except 
those for which at least one of the following is true: 

The symbol value is relocatable or external. 

The symbol is qualified. 

The symbol is redefinable (that is, defined by SET, MAX, MIN, or MICCNT). 

The symbol is defined by statements read by XTEXT or occurring between CTEXT and ENDX. 

The symbol is 8 characters beginning with | f . 

All defined micros are included in the system text record. 

All program-defined opcodes are also included. Machine and pseudo instructions automatically defined 
by COMPASS and opcodes defined by system text input (if any) to the assembly are not included. 

When a system text record is used as input to an assembly through the G or S option on a COMPASS 
control card, all of the micros and opcodes in the system text are automatically defined at the start of 
each assembly; however, the symbols in the system text are defined only for those assemblies that 
contain the SST pseudo instruction. 

Format: 



IOCATION 



OPERATION 



VARIABLE SUBFIEIDS 



rname 



STEXT 
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rname 



Name assigned to overlay; 1-7 alphanumeric characters, of which the first must 
be a letter (A-Z) and the last must not be a colon. It is placed in the prefix 
table that precedes the overlay. Refer to appendix B for record format. 

If rname is blank, COMPASS uses the name from the IDENT instruction and 
generates the systems text only. Otherwise, the systems text is generated in 
addition to the relocatable or absolute binary and precedes the binary output 
on the binary file. 



An entry in the variable field, if present, is ignored. 
Example : 



LOCATION 



OPERATION 



VARIABLE 



COMMENTS 



30 



HPRS 



TRTS 

IXX/X 



SYSCOM 



DATE 



IOENT 
STEXT 
BASE 
EQU 



EQU 
OPDEF 



ENOM 

MACRO 



ENDM 
MICRO 



END 



SYSTEXT 

MIXED 
100 



7777 

I,J,K 



1,10,»...* 



1 



SYSTEM CONSTANTS, SYMBOLS, 
AND COMMUNICATIONS AREAS 



SYSTEM-DEFINED MACROS 
AND OPDEFS 



1 



SYSTEM-DEFINED MICROS 

J 



4.3.8 LCC - LOADER DIRECTIVE 

The LCC pseudo instruction provides a means of including loader directives with the tables for a 
relocatable program. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LCC 


directive 
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directive 



First nonblank character following LCC to the first blank, 
formats, refer to the operating system reference manual. 



For directive 



A location field symbol, if present, is ignored. 

COMPASS writes a directive as a record in packed display code for subsequent interpretation by the 
loader (appendix B). COMPASS does not edit the directive; the loader recognizes illegal forms at load 
time. 



4.3.9 COMMENT— PREFIX TABLE COMMENT 

The COMMENT pseudo instruction inserts the character string specified in the variable field into the 
third through fourteenth words of the prefix table in the binary record. The prefix table, and thus the 
comment, is ignored by the loader but identifies the record for use by 7000 SCOPE utility programs 
such as LIBEDIT and CATALOG. If a subprogram contains more than one COMMENT instruction, the 
new comments are appended to the table for the most recent binary control card. If the subprogram 
contains a NOLABEL instruction, this instruction is meaningless. COMMENT, instructions following 
SEG and blank IDENT pseudo instructions are ignored without notification. 

Format: 



LOCATION 


OPERATION 


VARIA8LE SUBFIELDS 




COMMENT 


string 



First nonblank character following COMMENT to the last nonblank character; 
no more than 120 characters. 



string 

A location field symbol, if present, is ignored. Refer to section 4.3.4 for an example 



4.3.10 NOLABEL - DELETE HEADER TABLE 

The NOLABEL instruction modifies the format of the binary output produced by COMPASS for an 
absolute assembly by optionally suppressing header information. It is particularly convenient for 
generating deadstart programs which must be loaded at location zero or for writing Chippewa format 
CPU programs. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




NOLABEL 


1 
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I Optional; if the variable field contains a character string beginning with an I, 

COMPASS suppresses all prefix (77 ) tables, but retains the other program 
header tables. 

If the I option is omitted, COMPASS suppresses all of the following: 

Prefix tables (77 ) 
Overlay control tables (50 ) 
Multiple entry point tables (51 ) 
PPU header control tables 

A location field symbol, if present, is ignored. NOLABEL is not permitted in a relocatable CPU 
assembly. 

4.4 MODE CONTROL 

Mode control pseudo instructions influence the basic operating characteristics of the assembler. 
Specifically, the instructions allow the programmer to alter the way in which the assembler: 



Interprets binary data 

Generates character data 

Interprets the beginning of comments on statements 

Qualifies symbols or does not qualify them 

Interprets the R= instruction 



BASE pseudo instruction 
CODE pseudo instruction 
COL pseudo instruction 
QUAL pseudo instruction 
Bl==l or B7=l pseudo instruction 



In each case, the assembler has a default mode which it uses if one of these instructions is never used. 

4.4.1 BASE -DECLARE NUMERIC DATA MODE 

The BASE pseudo instruction declares the mode of interpretation for numeric data for which a base radix 
is not explicitly defined. Use of the BASE pseudo is optional; if BASE is not used in a subprogram, 
COMPASS evaluates unspecified numeric data as decimal. 

An alternate application of BASE is to define the previous base as a micro. 
Format: 



LOCATION 



mname 



OPERATION 



BASE 



VARIABLE SUBFIEIDS 



mode 



mname 



Optional 1-8 character micro name by which the previous BASE mode can 
be referenced in subsequent BASE instructions. If mname is present, the 
value of the micro named mname is (re)defined to be a single letter D, M, or 
O, corresponding to the BASE mode in effect prior to this BASE instruction. 
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mode Blank, in which case the base remains unchanged, or 1-8 characters, the 

first of which designates the new base as follows: 

O Octal assembly base; any subsequent use of a data item not 

specifically identified by an O, D, or B prefix or suffix is 
evaluated as octal. For example, the constants 15 and 15B 
are evaluated as 15g; constant 15D is evaluated as 17g. Any 
item containing an 8 or 9 without a D radix is flagged as 
erroneous. Exceptions are scale factors, character counts, 
shift counts (S modifier), and binary point positions, which 
are always considered decimal. 

D Decimal assembly base; any subsequent use of a data item 

not specifically identified by an O, D, or B prefix or suffix 
is evaluated as decimal., 

M Mixed assembly base; any subsequent use of a data item not 

specifically identified by anO, D, or B is evaluated as decimal 
if it is one of the following. Otherwise, it is evaluated as 
octal. 

VFD bit count 

IF, ELSE, or SKIP line count 

MICRO, OCTMIC, or DECMIC character count 

B, C, or I subfield in REP or RE PI 

DUP or ECHO line count 

Character count 

Shift counts (S modifier) 

Scale factors 

Binary point position 

COL column number 

DIS word count 

SPACE line count 

* Use base in effect prior to current base. The assembler records 

occurrences of BASE pseudo instructions. Each BASE * resumes 
use of the most recent entry and removes it from the list. When 
the subprogram contains more BASE * instructions than there are 
entries in the stack, COMPASS used a decimal base. 

other If the variable field is not blank and does not contain one of the 

above, COMPASS sets an error flag. 
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Examples: 



This example illustrates the affect of BASE on a VFD instruction that defines a 48-bit field 
containing 10 . 

Code Ge ne rated 



ooooooooooooooio 



0i»0 



000000000010 



0«»0 
0000 



Oi»M 
00000000 



000O0010 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 |30 














BASE 
VFO 

• 

BASE 
VFO 

• 
• 

BASE 
VFO 


O 

60/10 > 

* 1 

• I 

, 
%8/8 

• 1 

* 1 

M 

tt8/10 • 



The following example illustrates the micro capability of BASE: 



Di*M 



Hi»0 



LOCATION 



SAVES 



OPERATION 



BASE 



BASE 
BASE 



VARIABLE 



COMMENTS 



130 



=J- 



M ISAVE BASE IN USE 

I 

.CODE USING BASE M 

• 

*SAVEB* IRESTORE SAVED BASE 
RESTORE SAVED BASE 

! 



4.4.2 CODE - DECLARE CHARACTER DATA CODE 

The CODE pseudo instruction declares that until the next CODE pseudo instruction is encountered all 
constants, character strings, and character data items are to be generated in the specified code. 
Character data can be generated in ASCII f display, enternal BCD, or internal BCD, codes. If no 
CODE instruction is used, COMPASS generated display code. Codes are given in appendix D. 



Format: 



LOCATION 



OPERATION 



CODE 



VARIABLE SUBFIEIDS 



char 



f American Standard Code for Information Interchange. 
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char 



The first character of a string indicates the code conversion: 



A 


ASCII 


D 


Display 


E 


External BCD 


I 


Internal BCD 



A location field symbol, if present, is ignored. 
Example : 

Code Generated 



17252*20252<»0 00 00 000 

0-A 
57656<»60656HO 000000 

A,»E 
>»62<»23i»72<»?3OQ00OO0 

Ei»I 
«»66<»63i»76i»630 0000 0U0 

li»0 
17252<»20252«t000 00 00 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 






DATA 


0L0UTPOT | 






COOE 


ASCII | 






DATA 


0LOUTPUT | 






CODE 


EXTERNAL BCD 






DATA 


0LOUTPUT ' 






CODE 


INTERNAL BCc) 
0LOUTPUT , 






DATA 






CODE 


DISPLAY 1 






DATA 


0LOUTPUT 1 

1 



4.4.3 QUAL - QUALIFY SYMBOLS 

The QUAL pseudo instruction signals the beginning of a sequence of code in which all symbols defined in 
it are either qualified or are unqualified (global). If no QUAL is in use in a subprogram all symbols 
are defined as global. 

Within a QUAL sequence in which a symbol is defined, a symbol reference need not be qualified. 
Used outside the sequence, the symbol must be referenced as /qualifier/ symbol. Thus, a symbol 
and a qualifier become a unique identifier local to the sequence in which the symbol was defined. The 
same symbol used with a different qualifier is local to a different QUAL sequence. If a symbol is 
defined with no qualifier as well as being defined as qualified, a reference to the symbol within the 
QUAL sequence is assumed to be a reference to the qualified symbol rather than to the global symbol. 
In this case, a reference to the global symbol must be preceded by a blank QUAL and followed by a 
QUAL *. 

Default symbols and linkage symbols are not qualified. 



LOCATION 



OPERATION 



QUAL 



VARIABLE SUBFIELOS 



qualifier 
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qualifier 



A symbol qualifier or * or blank, as follows : 



qualifier 



blank 



1-8 character name, the first character of which cannot be $ or = 
or numeric. The qualifier cannot contain the characters 

+ - * / , or a| 
A blank terminates the qualifier. 

Any symbol defined subsequent to this QUAL up to the next 
QUAL must be referenced from outside the QUAL sequence as 

/qualifier/symbol 

The current qualifier appears as the third sub-subtitle on the 
assembly listing (section 11.1). 

The assembler resumes using the qualifier in use prior to the 
most recent QUAL. Two or more consecutive QUAL * instructions 
have the same effect as a single QUAL *. 

A blank variable field causes any symbols defined up to the next 
QUAL to be global. A global symbol does not require a qualifier. 



A location field symbol, if present, is ignored. 



NOTE 

The first attempt to redefine a global symbol from 
within a QUAL sequence results in A and U errors. 
The symbol is defined local to the QUAL sequence 
with a zero value. To avoid fatal errors, precede 
any redefinition instruction (SET, MAX, MEN, or 
MICCNT) within a QUAL sequence with a blank QUAL 
and follow it with a QUAL *. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 




Zl 
Zl 


QUAL 
8SS 

• 
• 
• 

OUAL 


z 1 

Izi QUALIFIED BY Z 

r 
i- 

8 .EQUATE SYMBOLS SO THAT 
/Z/Zl |21 IN Z CAN BE REFERRED 



|T0 AS Zl IN B 
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Examples : 



LOCATION 



OPERATION 



VARIABLE 



COMMENTS 



BCDE 



BCDE 



GLOB 



QUAL 
SX6 



EQ 

OUAL 
EQU 
QUAL 



8SS 



RJ 



RJ 



PASS1 



LOCI 

PASS2 

L0C2 



BCDE QUALIFIED BY PASS1 



BCOE QUALIFIED BY PASS2 
SYMBOLS GLOBAL FROM NOW ON 



/PASS1/BCDE 



GLOB IS GLOBAL 



JUMP TO PASS1 ROUTINE 



/PASS2/BCDEI JUMP TO PASS2 ROUTINE 



Location Code Generated 



1OT5* 77777777777777777776 



1UU5«5 

10*65 77777777777777777776 



LOCATION 



TBp 



TAG1 
TBG2 



TBG1 
TAG2 



TBG1 
T AG? 



OPERATION 



WACRO 

USE 

QUAL 

BSS 

VFO 

USE 

QUAL 

ENOM 



TAB 

USE 

QUAL 

RSS 

VFH 

USE 

OUAL 

FNDM 

TAR 



USE 

OUAL 

fSS 

VFO 

USE 

OUAL 

FNOM 



VARIABLE 



COMMENTS 



BLOCK, KWAL 

BLOCK 

KWAL 

ItTB 

60 f-± 



ONE, ONE 

ONF 

ONF 

lftB 

6D/-1 



T WO,TWO 



TWO 
TWO 
11TB 
60/-1 

* 



4-24 



60279900A 



4.4.4 Bl = 1 AND B7 = 1 - DECLARE THAT B REGISTER CONTAINS ONE 

The Bl=l and B7=l pseudo instructions declare that in this CPU subprogram, the contents of the Bl 
register or the B7 register, respectively, are one. These instructions do not produce code; they alter 
the way in which code is generated by the R= instruction (section 4. 8. 7) and define the symbol Bl=l 
or B7=l. If more than one instruction is used, the assembler uses the last one encountered. 

Formats : 



LOCATION 



OPERATION 



VARIABLE SU8FIELDS 



Bl=l 
B7=l 



A symbol in the location or variable field is ignored. 

Note that loading the respective B register with one is the user's responsibility. 

For an example of use, refer to R= described under Data Generation. 

4.4.5 COL - SET COMMENTS COLUMN 

The COL pseudo instruction sets the column number at which the comments field can begin when the 
variable field is blank. If no COL instruction is used in the subprogram, COMPASS uses 30. 



LOCATION 


OPERATION 


VARIABLE SUSFIELDS 




COL 


n 



An absolute evaluatable expression designating the column number; n > 12. When I 
base is M, n is assumed to be decimal. If n is less than 12, COMPASS sets the 
column at 12. If n is zero or blank, COMPASS sets the column to 30, the default 
column. 



A location field symbol, if present, is ignored. 
Example: 



hh 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 






COL 
USE 


1 — 

36 i 

[RETURN TO BLOCK 

i 



In this example, subsequent statements for which the variable field is blank cannot have comments 
beginning before column 36. 
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4.5 BLOCK COUNTER CONTROL 

Counter control pseudo instructions establish local blocks, labeled common blocks, and blank common 
blocks in addition to the absolute, zero, and literal blocks established by the assembler; they control 
use of all program blocks, and provide the user with a means of changing origin, location, and position 
counters. 



4.5.1 USE - ESTABLISH AND USE BLOCK 

USE establishes a new block or resumes use of an already established block. The block in use is the 
block into which code is subsequently assembled. A user may establish up to 252 blocks. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




USE 


block 



block Identifies block to be used, as follows: 

or blank Nominal block (absolute or 0) 

// Blank common block; for a relocatable subprogram, this block 

cannot contain data. The only storage allocation instructions 
that can follow are BSS and ORG. The BSSZ instruction is 
illegal because it presets the block to zeros. 

/name/ Labeled common block. A name can be a maximum of 7 characters 

and cannot include blank or comma. The first and last characters 
must not be colons. Conventions imposed by the loader or other 
assemblers or compilers could further restrict the use of names. 

name Local block. A name can be 1-8 characters, excluding blank or 

comma. Use of this name enclosed by brackets does not cause 
the block to become a labeled common block. For example, 
USE A and USE /A/ are different blocks. 

* Block in use prior to current USE, USELCM, or ORG. See 

diseussion following. 

A location field symbol, if present, is ignored. 

The nominal program block contains the entire program if no USE or USELCM is encountered. 
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In particular, redundancy between block names is permitted as follows: 

A labeled common block designated by /0/ can coexist with the program block designated by 0. 
Blank common designated by // can coexist with a labeled common block designated as ////. 

When a block is first established, its origin and location counters are zero and its position counter is 
either 60 (CPU subprogram) or 12 (PPU subprogram). When a different block than that in use is 
indicated, COMPASS saves the values of the current origin and position counters along with an 
indicator as to whether the next instruction is to be forced upper. If the most recently assembled 
instruction under the block is one that forces the next instruction upper, the first instruction 
assembled upon resumption of the block is forced upper. When the designated block has been 
previously established, COMPASS resumes assembly in the block using the last known values for 
the origin and position counters. The value of the location counter is not saved. Upon resumption of 
the block, it is set to the value of the origin counter. If a LOC had been used previously, resetting 
of the location counter to produce the desired results is the responsibility of the programmer. 

The assembler records occurrences of USE, USELCM, and ORG pseudo instructions (except USE * 
and USELCM *) and maintains a USE table of the most recent 50 occurrences. Each USE * and 
USELCM * resumes use of the most recent entry and removes it from the table. When the subprogram 
contains more USE * or USELCM * instructions than there are entries in the stack, COMPASS uses 
the nominal block. 



Examples: 

Location Code Generated 

13 0100000000 

35 1720*000000000000000 

1* 5130000000 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




M 


18 


ho 






USE 




1 , 

1 




GAMMA 


RJ 


ALPHA 


1 BLOCK IN USE 






USE 


DATA1 


1 BLOCK 0ATA1 IN USE 




SAB 


DATA 


1.0 


1 






USE 


» 


IRESUME USE OF BLOCK 






SA3 


SAM 


1 



Note that the SA3 is forced upper because the RJ causes a force upper of the next instruction in the 

block. 

Location Code Generated 



2615 00 



30002600 + 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 I 30. 






USE 
VFO 
USE 

• 
• 
• 

USE 
VFD 
USE 


TABLE JUSE TABLE LOCAL BLOCK 
6/0 | 

* IRESUME PREVIOUS BLOCK 

!• 
! '! 

TABLE 'RESUME USING TABLE 
6/1RX.18/S 

* RESUME PREVIOUS BLOCK 



Note how separate blocks can be used to facilitate packing of partial-word bytes into a table residing in 
a block other than the one primarily being used. 
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4.5.2 USELCM - ESTABLISH AND USE LCM BLOCK 

The USELCM pseudo instruction establishes or resumes use of a block assigned to 6000 Series Extended 
Core Storage (ECS) or 7600 Large Core Memory (LCM). For all but COMPASS Version 2 under SCOPE 
2, data generating instructions and symbolic machine instructions are illegal; only storage reservation 
pseudo instructions are allowed, that is, BSS and ORG. The USELCM instruction is illegal in PPU 
assemblies. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




USELCM 


block 



block Required; identifies the ECS/LCM block as follows: 

name Common block name; 1-7 characters excluding blank or comma. 

The first and last characters must not be colons. This form is 
illegal for SCOPE 2. 

// Blank common block; allowed only by SCOPE 2. This block cannot 

contain data. The only storage instructions that can follow are 
BSS and ORG. The BSSZ instruction is illegal here because it 
presets the block to zeros. 

/name/ Labeled common block; allowed only by SCOPE 2. A name can 

be 1 - 7 characters and cannot include blank or commas. The first 
and last characters must not be colons. 

* Block in use prior to current USE, USELCM, or ORG. Each 

USELCM * or USE * resumes use of the most recent entry in the 
USE table and removes it from the table. 

A location field symbol, if present, is ignored. 

The blocks provide a means of symbolically addressing (and for SCOPE 2, presetting) the job's ECS/ 
LCM field from a CPU program. Use of a block can be resumed through use of ORG or USELCM. 

Examples : 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ho 












LCMC 

BLOCl 

BL0C2 

BL0C3 


BASE 

USELCM 

BSS 

BSS 

BS5 

USE 

• 
• 

ORG 
BSS 
USE 


J 

LCM |ES1ABLISH AN0 USE LCM BLOCKf 

|UEFINE SYHBOL LCMC 

100 RESERVE 100 WORDS 

200 (RESERVE 200 WORDS 

* .RESUME PREVIOUS BLOUk 

• | 

• 

BLOC1+10Q0B ' 

20 Preserve 20 more words 
» 'resume previous block 



tThis form is illegal under SCOPE 2. 
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4.5.3 ORG - SET ORIGIN COUNTER 

ORG indirectly indicates the block to be used for assembly of subsequent code and specifies the value I 

to which the origin and location counters are to be set. COMPASS makes an entry in the USE table and 
saves the current origin and position counter values. 



Format: 



LOCATION 



OPERATION 



ORG 



VARIABLE SUBFIELDS 



exp 



exp Expression specifying the address to which the origin and location counters are 

to be set. Following ORG, the assembly resumes at the upper position of the 
location specified. COMPASS determines the block as follows: 

1. If the expression contains a symbolic address, COMPASS uses the block 
in which the symbol was defined. 

2. COMPASS uses the current block if the value of the expression is *, *L, 
or *0. If the origin and location counters are the same value, and no 
code has been assembled in the current location, the only effect of *, *L, 
or *0 is to force the next instruction upper. If a word is partially 
assembled, however, the code already assembled into the location is lost. 

If the counter values differ, * or *L sets the origin counter to agree with 
the location counter value; *0 sets the location counter to the origin counter 
value. 

3. An absolute expression causes use of the absolute block. In a relocatable 
assembly, this is the only way to establish the absolute block. All symbols 
defined in the absolute block are absolute. 

Any symbols in the expression must be already defined in the assembly and must not result in a 
negative relocatable value. It is not possible to ORG into the literals block. 

A location field symbol, if present, is ignored. 
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LOCATION 



ABC 



XYZ 



OPERATION 



USE 



OATA 



USE 
BSS 



ORG 
BSS 

ORG 
ORG 

USE 

USE 

USE 

USE 
USE 



VARIABLE 



COMMENTS 



|30 



ALPHA 



28,100,1000 



BETA 



ABC 



1000 



50 



xrz+ioo 



LOCATED IN ALPHA 



LOCATED IN BETA 



SETS ALPHA COUNTERS TO ABC 
AND RESUMES USE OF ALPHA 



SETS ABSOLUTE BLOCK COUNTER 
TO 50 AND BEGINS ITS USE 

• 

SETS BETA COUNTERS TO XYZ+100 



RESUMES ABSOLUTE 8L0CK 



RESUMES BLOCK ALPHA 



RESUMES BLOCK BETA 



RESUMES BLOCK ALPHA 



RESUMES NOMINAL BLOCK 
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4.5.4 BSS- BLOCK STORAGE RESERVATION 

The BSS instruction reserves core in the block in use by adjusting the origin and location counters. It 
does not generate data to be stored in the reserved area. A primary application is for reserving blank 
common storage. It can also be used to reserve an area to receive replicated code (see REP and REPI 
section 4. 8. 8). 



Format: 



LOCATION 



sym 



sym 



OPERATION 



BSS 



VARIABLE SUBFIELDS 



aexp 



If present, sym is defined as the value of the location counter after the force 
upper occurs. It is the beginning symbol for the storage area. 



aexp 



Absolute expression specifying the number of storage words to be reserved. 
All symbols must be previously defined; aexp connot contain external symbols. 
The value of the expression can be negative, zero, or positive and the value 
is added to both the origin counter and the location counter. A BSS or an 
erroneous expression causes a force upper and symbol definition but no storage 
is reserved. 



Example : 



LOCATION 



OPERATION 



VARIABLE 



COMMENTS 



130 



COMMON 



TAG 



USE 
BSS 
USE 



SA6 



BSS 



ft 

1000B 



COMMON«-500B, 



RESERVE 512 WORDS OF BLANK COMMON 



'DEFINE SYMBOL TAG 
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4.5.5 LOC - SET LOCATION COUNTER 

A LOC pseudo instruction sets the value of the current location counter to the value in the variable 
field expression. The location counter is used for assigning address values to location symbols. 
Changing the location counter permits code to be generated so that it can be loaded at the location 
controlled by the origin counter and moved and executed at the location controlled by the location 
counter. Thus, any addresses defined while the location counter is different from the origin counter 
will be correctly relocated only after the code is moved. 



Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LOC 


exp 



exp 



Relocatable expression specifying the address to which the location counter 
is to be set. Any symbols in the expression must be already defined in the 
assembly and must not result in negative relocation. 



A location field symbol, if present, is ignored. 

Following a LOC, if the value of the location counter differs from the origin counter, the location field 
is flagged with an L on the listing until a LOC *0, USE, ORG, or USELCM instruction resets the 
location counter to the value of the origin counter. 

A LOC instruction does not cause the assembler to switch from the current block to another. LOC 
causes the next instruction in the block to be forced upper. The only effect of LOC * or LOC *L is to 
force upper. Because COMPASS does not save the value of the location counter when it switches 
blocks, a USE, ORG, or USELCM for a different block effectively resets the location counter to the 
origin counter value. When use of the block is resumed, it is the responsibility of the user to reset 
the location counter to produce the desired results. 
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Example: 

la the following example, the first LOC is used to generate PPU code that is to be loaded into one 
PPU and transmitted to a different PPU for execution. The second LOC is used so that on the listing 
the address field contains the table ordinal rather than a load address. At the end of the table, a LOC 
instruction changes the location counter to resume counting under the first LOC. At the end of the 
program, LOC *0 returns the location counter to the value of the origin counter. 



Location 


Code Generated 


1 



710 






7100 






L 100 






L 100 


2MJ0 




L 101 


2MJ0 




t 102 


2«»00 




L 103 


6100 0100 





I 


205 




L 







L 





010 


L 


1 


011«* 


L 


2 


0121 


L 


3 


0132 


L 


k 


0136 


L 


5 


0i<*7 


L 


6 


02<*0 


L 


7 


1000 



L 215 

L 215 

L 2*»0 

72«*0 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


11 


18 [ 30 


Tl 


EQ.U 


1' 1 


CH 


EQU 


o I 




ORG 


7100 | 


RES 


BSS 







LOC 


100 1 


PPR 


PSN 


o ! 




PSN 


| 




PSN 


o 1 




EIM 


PPR,CH | 


• 


• 


• 


• 


• 


• 


• 


« 


• | 


PPR A 


BSS 


' 




LOC 


| 




CON 


PPR 




CON 


STM 1 




CON 


OPM 1 




CON 


EXR ' 




CON 


CHS 1 




CON 


OHP 1 




CON 


END 




CON 


1000 1 


• 


• 


• 


• 


• 


• | 


• 


• 


• 




LOC 


♦O-RES+PPR | 




BSS 


2<»0-* , 


END 


BSS 






LOC 


»0 I 
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4.5.6 POS - SET POSITION COUNTER 

The POS pseudo instruction sets the value of the position counter for the block in use to the value 
specified by the expression in the variable field. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




POS 


aexp 



aexp 



An absolute evaluatable expression having a positive value less than or equal to the 
assembly word size (60 for CPU, 12 for PPU). A negative value, or a value 
greater than 60 (or 12), causes an error. The value indicates the bit position 
within the current word at which the assembler is to assemble the next code 
generated. Use caution, because if the new position counter value is greater than 
the old position counter value, part of the word is reassembled. (New code is 
Ofted with previously assembled data. ) If the new position counter value is less 
than the old position counter value, the assembler generates zero bits to the 
specified bit position. If the value of aexp is zero, COMPASS assembles the next 
code in the following word. 



A location field symbol, if present, is ignored. 



CAUTION 



If the POS instruction is used on a word containing re- 
locatable or external addresses, undefined results may 
occur with no diagnostics. 

The POS instruction does not alter the origin and location counters. The position counter is never 
at the beginning of an instruction. At the beginning of a new operation, if a data value has been 
stored into bit (the rightmost bit) of a word, COMPASS increments the origin counter and the 
location counter and resets the position counter to 60 (or 12). 

A POS *P has no effect whereas a POS $ subtracts one from the counter. 



4.6 SYMBOL DEFINITION 

The pseudo instructions EQU, =, SET, MAX, MIN, and MICCNT permit direct assignment of 21 -bit 
values to symbols. The values can be absolute, relocatable, or external. Register designators are 
not valid in the expressions. Subsequent use of the symbol in an expression produces the same result 
as if the value had been used as a constant. In the listing of the symbolic reference table, a refer- 
ence to an EQU, =, SET, MAX, MIN, or MICCNT instruction is flagged with a D. Symbols defined 
using EQU and = cannot be redefined; symbols defined using any of the other symbol definition 
instructions can be redefined. 
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4.6.1 EQU OR =— EQUATE SYMBOL VALUE 

An EQU or = pseudo instructionipermanently defines the symbol in the location field as having the value 
and attributes indicated by the expression in the variable field. 

Formats : 



or 



LOCATION 



sym 
sym 



OPERATION 



EQU 



VARIABLE SUBFIELDS 



exp 
exp 



sym 
exp 



A location symbol is required. See section 2.4 for symbol requirements. 

An evaluatable expression. Any symbols in the expression must be previously 
defined or declared as external. The expression cannot contain symbols 
prefixed by =S or = X unless the symbols have also been defined conventionally. 
If the expression is erroneous, COMPASS does not define the location symbol 
but flags an error. 



Examples: 



201*37 

7<t 

3 

7k 

6<»27i 



LOCATION 



OPS 

LINP 

OH 

PAGESIZ 

LGOPS 



OPERATION 



EQU 
EQU 



VARIABLE 



COMMENTS 



20^378 

7<*B 

3 

LINP 

♦-OPS 
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4.6.2 SET -SET OR RESET SYMBOL VALUE 



A SET peeudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the expression in the variable field. A subsequent SET using the same symbol redefines 
the symbol to the new value and attributes. SET can be used to redefine symbols defined by SET, MAX, 
MIN, or MICCNT, only. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


SET 


exp 



sym A location symbol is required. See section 2. 4 for symbol requirements. 

exp An evaluatable expression. The expression cannot include symbols as yet 

undefined and cannot contain symbols prefixed by =S or =X unless the symbols 
are also defined conventionally. 

If the expression is erroneous, COMPASS does not define the symbol but 
issues a warning flag. 

The symbol in the location field cannot be referred to prior to its first definition. 

Examples : 



17 
7k 
22 
76 
2k 



20 



LOCATION 



A 
B 
C 
B 
C 
D 

AA 



OPERATION 



EQU 
SEf 
SET 

SET 
SET 
8SS 
SET 



VARIABLE 



COMMENTS 



15 
*P 

A*3 

8+2 

C+2 

F*A 

AA 

16 



A HAS VALUE OF 15 

B HAS VALUE OF POSITION COUNTER 

C HAS VALUE A+3 OR 18 

ILLEGAL, B IS OOUBLY DEFINED 

LEGAL, C CHANGES FROM 18 TO 20 

ILLEGAL, F AS YET UNOEFINED 

ILLEGAL, REFERENCE PRECEDES 
FIRST DEFINITION 
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4.6.3 MAX - SET SYMBOL TO MAXIMUM VALUE 

The MAX pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the largest (most positive) value of the expressions in the variable field. A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 
Conversely, MAX can be used to redefine symbols defined by these instructions. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


MAX 


expj.expg exp n 



sym 



exp. 



A location field symbol is required. See section 2.4 for symbol requirements. 

An evaluatable expression. Any symbols in the expression must be previously 
defined. The expression cannot contain symbols prefixed by =S or =X unless 
the symbols are also defined conventionally. 



The expressions should have similar attributes. No test is made for attributes. The test for maximum 
value is made in pass one. In testing for the maximum value in pass one, COMPASS uses values for 
relocatable symbols relative to block origins. 

NOTE 

During pass two, the expression selected in pass one is 
used. The relocatable symbols have been reassigned 
values relative to program origin and these values are 
used for the final value of the expression selected in the 
first pass. 

If any of the expressions are erroneous, COMPASS does not define the symbol but issues a warning flag. 
The symbol in the location field cannot be referred to prior to its first definition. 



Example : 



5 
6 
2 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 




PT3 

PT31 

PT32 

SYM 


EQU 
EQU 
EQU 

MAX 


5 | 

6 i 
2 i 

PT3,PT31,PT32 

i 



60279900A 



4-37 



4.6.4 MIN - SET SYMBOL TO MINIMUM VALUE 

A MIN pseudo instruction defines the symbol in the location field as having the value and attributes 
indicated by the minimum or least positive value of the expressions in the variable field. A subsequent 
SET, MAX, MIN, or MICCNT using the same symbol redefines the symbol to the new value. 
Conversely, MIN can be used to redefine symbols defined by these instructions. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


sym 


MIN 


expj , exp 2 , . • . , exp n 



sym 



A location symbol is required (section 2. 4). 



exp. 



An evaluatable expression. Any symbols in the expression must be previously 
defined. The expression cannot contain symbols prefixed by =S or =X unless 
the symbols are also defined conventionally. 



The expressions should have similar attributes; no test is made for attributes. 

The test for minimum value is made in pass one. In testing for the minimum value in pass one. 
COMPASS uses values for relocatable symbols relative to block origins. 

NOTE 

During pass two, the expression selected in pass one is 
used. The relocatable symbols have been reassigned 
values relative to program origin and it is these values 
that are used for the final value of the expression which 
was selected in the first pass. 

If any of the expressions are erroneous, COMPASS does not define the symbol but issues a warning 
flag. 

The symbol in the location field cannot be referred to prior to its first definition. 
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4.6.5 MICCNT - SET SYMBOL TO MICRO SIZE 

The MICCNT pseudo instruction defines the symbol in the location field as having a value equal to the 
number of characters in the value of the micro named in the variable field. A subsequent SET, MAX, 
MIN, or MICCNT using the same symbol redefines the symbol to the new value. Conversely, MICCNT 
can be used to redefine symbols defined by these instructions. 

Format: 



LOCATION 



sym 



OPERATION 



MICCNT 



VARIABLE SUBFIELDS 



mname 



sym 



A location symbol is required (section 2.4). 



mname 



Name of a previously defined micro; it may be a system micro or may have 
been defined through MICRO, OCTMIC, DECMIC, or BASE. If mname has 
not been previously defined, the location symbol is not defined (or redefined) 
and a warning flag is issued. 



Example : 



23 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


11 


18 [ 30 


MSG 

MSIZE 

MSG 
MSG 

MSIZE 


MICRO 

* 
• 
• 

MICCNT 

• 
• 
* 

MICRO 
HICRO 

MICCNT 


1 

1»,»STRING» |DEFINE 6-CHARACTER MICRO 

1* 

I* 

• • 

MSG 'MSIZE EQUALS 6 

1. 
U 

1, ^ALPHANUMERIC * M SG#* 19 CHAR. MICRO 
^♦•ALPHANUMERIC STRING* 19 CHAR. MICRO 

MSG JMSIZE EQUALS 19 
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4.6.6 SST - SYSTEM SYMBOL TABLE 

An SST pseudo instruction defines system symbols, with the exception of the symbols noted, as if the 
symbols had been defined in the subprogram. 

The symbols are in a systems overlay or on a systems text file accessed through the S or G list 
options on the COMPASS control card (section 10. 1. 2). 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




SST 


sym 1 ,sym 2 ,...,sym n 



symj One or more symbols on the file that are not to be defined. 

A location field symbol, if present, is ignored. 
Refer to section 4. 3. 4 for an example of use. 



4.7 SUBPROGRAM LINKAGE 

Pseudo instructions ENTRY and EXT do not define symbols but either declare symbols defined within 
the subprogram as being available outside the subprogram or declare symbols referred to in the 
subprogram as being defined outside the subprogram. 



4-40 



60279900A 



4.7.1 ENTRY - DECLARE ENTRY SYMBOLS 

The ENTRY pseudo instruction specifies which of the symbolic addresses defined in the subprogram can 
be referred to by subprograms compiled or assembled independently; ENTRY lists entry points to the 
current subprogram. ENTRY is illegal in PPU assemblies. 

Format: 



LOCATION 



sym. 



OPERATION 



ENTRY 



VARIABLE SUBFIELDS 



sym 1 ,sym 2 ,...,sym r 



Linkage symbol; 1-7 characters of which the first must be alphabetic (A-Z) and the 
last must not be a colon. The symbol cannot include the following characters: 

+ - * / blank , or a| 



Each symbol must be defined in the subprogram as nonexternal (cannot begin 
with =X or be listed on an EXT pseudo instruction). Entry point symbols 
must be unqualified (section 2.4.5). 

A location field symbol, if present, is ignored. 

A list of all entry points declared in the subprogram precedes the assembly listing. 

Example: 



Location 



Code Generated 



110 
110 
110 



5120000100 



7J720 



111 5110000002 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 














I DENT 


CT, CONTROL, CONTROL 






ABS 


1 






ENTRY 


MODE | 






ENTRY 


ONSW . 






ENTRY 


OFFSW 1 






ENTRY 


ROLLOUT | 






ENTRY 


SETPR . 






ENTRY 


SETTL 1 






ENTRY 


SWITCH 1 






ORG 


HOD 




CONTROL 


BSS 


1 




iODE 


SA2 


ACTR | 






SX7 


X2 ' 






SA1 


2 1 

1 






• 
• 


1 
I 
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4.7.2 EXT - DECLARE EXTERNAL SYMBOLS 

The EXT pseudo instruction lists symbols that are defined as entry points in independently compiled 
or assembled subprograms for which references can appear in the subprogram being assembled. 
The EXT pseudo instruction is illegal in an absolute subprogram. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




EXT 


sym 1 ,sym 2 sym n 



sym. 



Linkage symbol, 1-7 characters of which the first must be alphabetic (A-Z) and the 
last must not be a colon. The symbol cannot include the following characters; 



+ - * / blank , or a 

These symbols must not be defined within the subprogram. External symbols 
are unqualified. 



A location field symbol, if present, is ignored. 

An external reference is flagged with an X in the address field in the listing of code generated. All 
external symbols are listed in the header information for the assembly listing. 
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4.8 DATA GENERATION 

The instructions described in this section are the only pseudo instructions that generate data. All 
other program data is generated through symbolic machine instructions. An instruction that 
generates data cannot be used in a blank common block. The pseudo instructions that generate data 
are: 



BSSZ 

blank operation field 

DATA 

DIS 

LIT 

VFD 

CON 

R= 

REP or RE PI 



Generates zeroed words 

Generates one zeroed word 

Generates one or more words of data 

Generates one or more words of data 

Generates literals block entries 

Places expression values in user-defined fields 

Places expression values in full words 

For use in macros; R= assumes that either (Bl)=l or (B7)=l and 
generates increment instructions accordingly 

Does not actually generate object code at assembly time but 
causes the relocatable loader to repeatedly load a sequence of 
code into a reserved blank storage area. 



4.8.1 BSSZ AND BLANK OPERATION FIELD— RESERVE ZEROED STORAGE 

The BSSZ instruction reserves zeroed core in the block in use. The origin and location counters are 
adjusted by the requested number of words and the assembler generates data words of zero to be 
loaded into the reserved area. An instruction that contains a symbol in the location field but has a 
blank operation field has the same effect as a BSSZ of one word. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


BSSZ 


aexp 



sym 



aexp 



If present, sym is defined as the value of the location counter after the force 
upper occurs. The symbol identifies the beginning of the reserved storage area. 

Absolute evaluatable expression specifying the number of zeroed words of 
storage to be reserved. The expression cannot contain external symbols or 
result in a relocatable or negative value. 



A BSSZ or an erroneous expression causes a force upper and symbol definition but no storage is 
reserved. 
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A BSSZ or group of BSSZ instructions of six or more words produces an REPL table in object code to 
reduce the physical size of the object program (appendix B). 

Only the first word appears on the listing. 

4.8.2 DATA - GENERATE DATA WORDS 

The DATA pseudo instruction generates one or more complete 60-bit or 12-bit data words in the 
current block for each item listed in the variable field. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


DATA 


item, , item 2 » . . . , iteni 



sym 



If present, sym is assigned the value of the current location counter after 
the force upper occurs. It becomes the symbolic address of the first item 
listed. 



item. Character, octal numeric, or decimal numeric data item, according to 

specifications described in section 2. 7. Floating point notation is illegal in 
PPU assemblies. Items are separated by commas and terminated by a blank. 
A literal cannot be used as an item. 

A DATA pseudo instruction always forces upper. A blank item does not cause generation of a data word. 

Unless the D list option is selected, only item., appears on the listing. 

Examples : 



Location 



Code Generated 



552 l«i0717O000OO000000O0 

553 itOOOOOOOOQOOaOOOOQOO 
55k 03J.71520111W1500000Q 

555 17252i»20252iiBOOflOBflO 

556 00000000009000000090 

557 172051«»63iA63Hi631*6 
56H i6«*03i%631V6TM63K& 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 












OPTB 
OPT 
OPTT 
OPTO 

OPTY 


DATA 
DATA 
OATA 
OATA 

OATA 


OLLGO 1 
1BS59 ! 
OLCOHPILE 1 
0LOUTPUT,0 1 

1.3EE l 
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Location 



Code Generated 



1250 


7070 


1251 


7770 


1252 


0000 


1253 


Q03<* 


125* 


5501 


1255 


0000 


1256 


0506 


125/ 


0123 


1260 


7773 


1261 


0*01 


126 2 


2«f01 



D<»0 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ho 












)AT 


PERTPH 
BASE 

• 

DATA 

DATA 

DATA 
DATA 


' 

• I 

r070,-7,0,lRi 

2C A,0LEF 

3123,-^ | 
■t*0ATA* 1 



4.8.3 DIS— GENERATE WORDS OF CHARACTER DATA 

The DIS pseudo instruction generates words containing character data. The instruction can be used 
conveniently when a character data string is to be used repeatedly. Unless the D list option is selected 
only the first word of character data appears on the listing. The instruction has two formats: 

Format one : 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


DIS 


n, string 



sym 



If present, sym is assigned the location counter value after the force upper 
occurs. It is the symbolic address of the first word containing the character 
string. 



An absolute evaluatable expression specifying an integer number of words to be 
generated. When base is M, COMPASS assumes that n is decimal. 



string 



Character string 



For a CPU program, COMPASS takes 10 times n characters from the string and packs them as they occur 
10 characters per word into n words. For a PPU program, COMPASS takes two times n characters from 
the string and packs them as they occur two characters per word into n words. If the statement ends 
before 10 x n (or 2 x n) characters, the remainder of the requested words are filled with blanks. 
If n is 0, COMPASS assumes the instruction is in format two. 
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Format two: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


DIS 


, dstringd 



sym 

d 
string 



If present, sym is assigned the location counter value after the force upper 
occurs. It is the symbolic address of the first word containing the character 
string. 

Delimiting character 

Character string; any character other than delimiting character 



In this form, the string must be bounded by delimiters. The comma is required. The characters between 
the two delimiting characters are packed into as many CPU or PPU words as are needed to contain them. 
Twelve zero bits are guaranteed at the end of the character string even if COMPASS must generate an 
additional word for them. If COMPASS detects the end of the statement before it detects a second 
delimiting character, it produces a fatal error. 



Examples: 



Location Code Generated 



561 0705160522012«»055535 

562 55032025552717220*23 

563 0705160522012*055535 
56* 55032025552717220*23 
565 OOOOOOOOOOOOOOOOOOOO 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 




ONE 
TWO 


DIS 
DIS 


2, GENERATE ?1 CPU WORDS 

.•GENERATE 2| CPU WORDS* 

1 
1 
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Location 



Code Generated 



1*02 


0705 


1*03 


1605 


1*0* 


2201 


1*05 


2*05 


1*06 


553* 


1*07 


3355 


1*10 


2020 


Ull 


5527 


1*12 


1722 


1*13 


0*23 


1*1* 


0705 


1*15 


1605 


1*16 


2201 


1*17 


2*05 


l<f2D 


553* 


1*21 


3355 


1*22 


2020 


1*23 


5527 


1*2* 


1722 


1*25 


0*23 


1*26 


0000 



D(»M 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


II 


18 1 30 




PPU 

BASE 
OIS 

DIS 


: 1 

1 

i 

10. GENERATE 10 PP WORDS 

i 
1 
1 

1 

1 

! 
i 
»*GENERATE 10 PP WORDS* 
1 
1 
1 
1 
1 



4.8.4 LIT - DECLARE LITERAL VALUES 

A LIT pseudo instruction generates data words in the literals block. This instruction and the 
= prefix to a data item provide the only means of generating data in the literals block. The LIT 
pseudo instruction assures sequential entries for a table of values. 

Format: 



LOCATION 



sym 



OPERATION 



LIT 



VARIABLE SUBFIELDS 



itenij , item„, . . . , item 



sym 
item. 



If present, sym is assigned the value of the literals block location counter 

At least one and not more than 100 words of character, octal numeric, or 
decimal numeric data items. Section 2. 7. 3 contains specifications. Items 
are separated by commas and terminated by a blank. Floating point data 
items are illegal in PPU assemblies. 



60279900A 



4-47 



COMPASS enters data items into the literals block in the order specified. 

If the converted binary values for all the data items listed with a single LIT match an existing literal 
block sequence, they are not duplicated. If, however, any item in the list does not match an entry in 
the block, the entire sequence is generated. A literal item subsequently referred to through an 
= prefix is not duplicated. A null item (e.g. H** or OL) does not cause a word to be generated. 

Examples : 



Location Code Generated 



000611 
000612 
000613 
00061* 
000615 



611 



LOCATION 



POOL 



OPERATION 



LIT 



VARIABLE 



3. 1 , 1. 59265 , 2. 7ia2182, 57 .2 957795EE1 



CONTENT CF LITEPALS BLOCK. 



172161*631*631*631*6 
17206275576**1776271 
1721533735113601**26 
1731*363651**0663121 
165133330335*0576566 



OQt-Y-Y-Y- 
0P]>.*6?)+ 
0Q$*?I3A9V 
0Y8t.*L5vYQ 
N<00C25.r»v 



Location Code Generated 



7**7 
7*53 
71*56 

C0NTFNT CF LITFRALS BLOCK 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 I 30 




N2 


LIT 
LIT 

LIT 


1R1, 7070,7,01 
2C A,0LEF 1 
H»LITERALS» 1 



7ht*7 
7*5 
7*51 
7*52 
7*53 

7*55 
7*56 
7*57 
7*60 
7*61 



003* 

7070 
0007 
0000 
55t)l 
0000 
0506 
1*11 
2*35 
2201 
1*23 



1 
G 



EF 
LI 
TE 
RA 
LS 
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4.8.5 VFD - VARIABLE FIELD DEFINITION 

The VFD instruction generates data in the current block by placing the value of an expression into 
field of the specified size. 

Format: 



LOCATION 



sym 



OPERATION 



VFD 



VARIABLE SUBFIEtDS 



itenij/expj , item 2 /exp 2 , .... item^ /exp n 



sym 



For a CPU assembly, the location field can contain sym, plus, minus, or 
blank, as follows: 



sym 



blank 



If a symbol is provided in the location field, a force upper occurs 
and the value of the location counter following the force upper is 
assigned to the symbol. The symbol identifies the first word of 
data generated by the VFD. 

Causes a force upper. Data generation begins in a new word. 

COMPASS generates zero bits to the next quarter word boundary, 
at which point the first field begins. 

COMPASS begins the first field at the current value of the position 
counter. 



For a PPU assembly, if the location field contains a plus, minus, or a symbol, 
data generation begins in a new word. If the location field is blank, the first 
field begins at the current value of the position counter. 

item An unsigned constant or previously defined symbol having a value specifying 

a positive integer number of bits for the field to be generated; maximum field 
size is 60 bits for both CPU and PPU assemblies (60 being the maximum 
number of significant bits for an expression value). When base is M, item, 
is assumed to be decimal notation. 

expj An absolute, relocatable, or external expression, the value of which will be 

inserted into the field specified by itemj. For CPU assemblies, if expj is a 
relocatable or external value, itemi must be at least 18 bits and must end at 
bit 30, 15, or 00, the only legal positions for addresses in 30-bit CPU 
instructions. 

The expression is evaluated using the specified field size. Character constants 
are right or left adjusted in the field according to the type of justification 
indicated. 

Each field is generated as it occurs. For a CPU assembly, if the next instruction that generates code 
in the block is not a VFD with a blank location field, and the last VFD field in the current VFD ends to 
the left of a quarter word boundary, COMPASS inserts zero bits up to the next quarter word boundary. 
These zero bits do not show on the assembly listing. Remaining parcels are then filled with no- 
operation instructions. 
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When a VFD instruction that does not have a location field entry immediately follows another VFD in 
the same block, no padding with zeros or forcing upper occurs; fields are generated sequentially as 
they are specified. 

Following a VFD, the position counter contains the number of bits remaining to be assembled in the 
last word in which data was generated by the VFD. 



Examples: 

Location Code Generated 



31 

566 2«*Oi0200000023000551 

567 00000005665555555555 

570 77777777«» 

000000000000 

571 11172*»01550155555531 

572 00000015052323010705 

573 031117000000033 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ho 




ALPHA 
TABLE 


SET 

VFO 
VFO 

VFO 
VFO 
VFD 


25 , 

36/3CTA8, 6/13,18^ A BLOC 
30/*-l,30/5H ,ALPHA/-0 

1 
*P/ 1 
30/0HIOTA,6/lRA,2«t/0AX + l 

6O/0RMESSAGE,3 0/3LCIO,15/0R0 
i 



Location 



Code Generated 



1310 


333% 


1311 


3536 


1312 


37%0 


1313 


%1%2 


131% 


kZhk 


1315 


0010 


1316 


0011 


1317 


7765 


1320 


07 07 



Of»M 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 




N% 
All 


PPU 

BASE 

VFD 

VFO 


1 

M I 
60/10R0123%56789 

1 
1 
1 
12/10,12/11, 12/-12.12/-7070 

1 
1 



4.8.6 CON - GENERATE CONSTANTS 

The CON pseudo instruction generates one or more full words of binary data in the block in use. It 
differs from DATA in that it generates expression values rather than data items and differs from VFD 
in that the field size is fixed. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


CON 


exp 1 ,exp 2 ,...,exp n 



sym 



If present, sym is assigned the value of the location counter after the force 
upper occurs. 



exp. 



An absolute, relocatable, or external expression the value of which will be 
inserted into a field having a size of one word. For PPU assembly, floating 
point is not allowed; for CPU assembly, double precision is not allowed. 
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Examples : 
Location 



1460 
1461 
1462 
1463 
1464 
1465 
1466 
1467 
1470 
1471 

Location 



L 
L 
L 
L 

L 



L 
L 
L 



57W 


i 
2 
3 



75 

76 

77 

67* 



Code Generated 



0000 
0006 
0003 
2204 
0024 
0000 
0006 
0003 
2172 
0024 

Code Generated 



000000000013000000055 
00000 00 00000 0000 062 
0000000000OO0000O064 
000 00 00 00 00 00 00 060 



00000 0000000000066 
00O000OOQO00OOOO0O76 
00000 000 000000055 



LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 


11 


18 


Uo 


MS<?1 


CON 





1 




CON 


6 


1 




CON 


3 


1 




CON 


FAIL 


1 




CON 


20 


1 


MSG2 


CON 









CON 


6 


1 




CON 


3 




. 


CON 


PASS 


] 




CON 


20 


1 


LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 


11 


18 


Uo 


no 


BSS' 





— 1 




LOC 





1 




CON 


1R 


i00 




CON 


IR] 


01 




CON 


1R* 


'02 




CON 


1R= 


I 03 


: 


• 


• 


\ • 




* 


-• 


1 • 




-• 


• ' 


i -• 




CON 


1R» 


1/5 




CON 


IR" 


176 




CON 


1R 


\ 77 




LOC 


»0 



4.8.7 R =.- CONDITIONAL INCREMENT INSTRUCTION 

The R= pseudo instruction generates a CPU increment unit instruction depending on the contents of the 
variable subfields and on whether or not the subprogram earlier contained a Bl=l or B7=l pseudo 
instruction (section 4.4.4). 

Use of R= augments macro definitions and increases optimization of object code. It is illegal in a 
PPU program. 

The A list option controls listing of substituted instructions. 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


R= 


reg.exp 



sym 



Optional, if present, sym is assigned the value of the location counter after 
the force upper occurs. This force upper occurs whether the R= generates an 
instruction or not. 
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reg 



exp 



A register designator (A. X. or B) snd a digit (0-7) which COMPASS 
concatenates with S to form the instruction operation code. 

Operand register or value expression. If the second subfield is the same two 
characters as reg, no instruction is generated. 

If the expression value is 0, the variable field is BO. 

If the Bl=l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1, the variable field of the instruction is Bl, 
Bl+Bl, or -Bl, respectively. 

If the B7=l instruction has been assembled prior to this instruction and the 
expression value is 1, 2, or -1, the variable field for the instruction is B7, 
B7+B7, or -B7, respectively. 

In all other cases, the variable field is the register or value indicated by the 
expression. 



Examples: 

1. R= used with BI=1 



Code Generated 



66911 



6130000003 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 |30 










I 




Bl=l 

R= 

S83 

R= 

SB3 


83,? 1 




81*81 I 
B3,3 

3 •■ 1 



2. R= used with Bl^l 



Code Generated 



7150777776 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 












TAG 


R= 
SX5 


"•:i i 
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3. Expression is same as register designator: 



LOCATION 



RFG 



OPERATION 



MICRO 

R= 

:R* . • 



VARIABLE 



COMMENTS 



|30 



1,,*85» 
85,*REG* 



i 



No instruction is generated; SB5 B5 would be a no operation instruction. 

4.8.8 REP AND REPI-<SENERATE LOADER REPLICATION TABLE 

The REP and REPI instructions cause the assembler to generate an REPL loader table so that when the 
subprogram being assembled is loaded, the loader will load one or more copies of a data sequence. 
For the REPI instruction, the loader generates the copies immediately upon encountering the table; 
for REP, the replication takes place at the end of loading. 

Replication of object code is valid in relocatable assemblies only. It is particularly useful for setting 
one or more blocks of storage to a given series of values or for generating tables. 

Data to be replicated must not contain any external references or common block relocatable addresses. 
For REPI, data must be in previously assembled text. 

Format: 



LOCATION 



OPERATION 



REP 
REPI 



VA1HA3LE SUBFIELDS 



S/saddr, D/daddr, C/rep, B/bsz, I/inc 



A location field symbol, if present, is ignored. 
The variable field subfields can be in any order. 



S/saddr 



D/daddr 



Relocatable expression specifying first word address of code to be copied. 

The S/saddr subfield must be provided. If it is zero, or omitted, the assembler 

flags the instruction as erroneous and does not generate an REPL loader table. 

Relocatable expression specifying the destination of the first word of the first 
copy. If D/daddr is omitted, the assembler sets daddr to zero, and, when 
daddr is zero, the loader uses saddr plus bsz for the destination address. 

Note that room for the repeated data must be reserved in the destination block. 
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C/rep Absolute expression specifying the number of times code is to be copied. When 

base is M, COMPASS assumes that rep is a decimal value. If C/rep is 
omitted, the assembler sets rep to zero. When rep is zero or one the loader 
makes one copy. 

B/bsz Absolute expression specifying the number of words to be copied (block size). 

When base is M, COMPASS assumes that bsz is decimal. 

If B/bsz is omitted, the assembler sets bsz to zero. When bsz is zero or one, 
the loader copies one word. 

I/inc Absolute expression specifying the increment size in words. When base is M, 

COMPASS assumes that inc is in decimal. 

The increment size is the number of words between the first word of each copy. 
When inc is zero or omitted, the loader uses bsz as the increment size. The | 

loader writes the first copy starting at daddr, the second starting at daddr+inc, 
the third at daddr + 2 x inc, etc. until the rep count is exhausted. 

The origin and location counters for the block containing the daddr are not advanced by a value of 
inc x rep. Storage reservation for replicated code is the responsibility of the user. 

Rules for replication: 

1. The S subfield cannot be omitted 

2. Room must be reserved for the copies in the destination block (for example, through ORG or BSS) 

3. REP and REPI can be used in relocatable assemblies only 

4. Data to be replicated must not contain any external references or common block relocatable 
addresses 

5. For REPI, data must be in previously loaded text 



Example : 



Location 



Code Generated 



5017 
5020 
5021 
•5022 
5023 
502«» 



5251 



10 



00000000000000000015 
00000000000000000020 
00000000000000007070 

oooooooooooooonooooi 

00000000000000000005 
17216300D000O0000000 

13 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 








I 




pr 

BA 

I 

00 


USE 
OflTfl 

EQU 
USE 
RSS 
USE 
REPI 


10 

NEWP | 

15,20,70708, 1,5, 3. 1«» 

1 

1 

1 

♦-RA+5 
OBIOCK | 

RC*I , 

* 1 

S/BA,0f0A,B/I-5,C/RC,I/I 
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4.9 CONDITIONAL ASSEMBLY 

The following pseudo instructions permit optional assembly or skipping of source code. A special form, 
SKIP, causes unconditional skipping. COMPASS provides IF test instructions that: 

Test for assembly environment (IFCP and IFPP) 

Compare values of two expressions (IFop) 

Compare values of two character strings (IFC) 

Test the attribute of a single symbol or an expression (IF) 

Immediately following the test instruction are instructions that are assembled when the tested condition 
is true and skipped when the condition is false. Skipping is terminated either by a source statement 
count on the IF instruction, or by an ENDIF, an ELSE, or an END. 

The statement count, when used, is decremented for instruction lines only; comment lines (identified by 
* in column one) are not counted. Determining the IF range with a statement count produces slightly 
faster assembly than using the ENDIF. 

The results of an IF test are determined by the values of expressions in pass one; the value of a 
relocatable symbol is relative to the USE block in which it was defined. The value of an external symbol 
is if the symbol was declared as external. If the symbol was defined relative to a declared external, 
the value is the relative value. 



4.9.1 ENDIF -END OF IF RANGE 

An ENDIF causes skipping to terminate and assembly to resume. When the sequence containing the 
ENDIF is being assembled, or is controlled by a statement count, the ENDIF has no effect other than 
to be included in the count. 

Skipped instructions such as macro references are not expanded. Thus, any ENDIF that would have 
resulted from an expansion is not detected. 

Format: 



IOCATION 



ifname 



OPERATION 



ENDIF 



VA*IABIE SUBFIELDS 



ifname Name of an IF, SKIP, or ELSE sequence; or blank 

Skipping of a sequence initiated by an IF, SKIP, or ELSE that is assigned a name can be terminated 
by an ENDIF specifying the sequence by name, or by any unnamed ENDIF. Any ENDIF terminates 
skipping of an unnamed sequence that is not controlled by a source line count. A named ENDIF 
terminates the named IF, SKIP, or ELSE and any unnamed IF, SKIP, or ELSE sequences in effect 
that are not under line count control. 
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4.9.2 ELSE - REVERSE EFFECTS OF IF 

Through the ELSE instruction, COMPASS provides the facility to reverse the effects of an IF test 
within the IF range. An ELSE detected during skipping causes assembly to resume at the instruction 
following the ELSE. An ELSE detected while a sequence is being assembled initiates skipping of source 
code following the ELSE. Skipping continues until: 

1. A statement count specified on the ELSE is exhausted 

2. A second ELSE is detected for the sequence 

3. An ENDIF is detected for the sequence 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


Ifname 


ELSE 


jtoct 



ifname 



Name of an IF, SKIP, or ELSE sequence, or blank. 



jtoct 



Optional absolute expression specifying integer number of source lines to be 
skipped. It has no effect if the ELSE resumes assembly. When the base is 
M, COMPASS assumes that £nct is decimal. 



An ELSE specifying the sequence by name or any unnamed ELSE terminates skipping of a sequence 
initiated by an IF, SKIP, or an ELSE that has an assigned name. Skipped instructions such as macro 
references are not expanded; any ELSE that would have resulted from the expansion is not detected. 



4.9.3 IFCP AND IFPP - TEST ENVIRONMENT 

The IFCP instruction tests for a CPU assembly; the IFPP instruction tests for a PPU assembly. When 
the test is satisfied, COMPASS assembles instructions in the IF range. When the test is not satisfied, 
COMPASS skips the instruction. 

Format: 



LOCATION 



VARIABLE SUBFIELDS 



ifname 



IFCP or 
IFPP 



£nct 



ifname 



Optional 1-8 character name. 
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jfnct 



Optional absolute evaluatable expression specifying an integer count of the 
number of statements to be skipped. When base is M, COMPASS assumes 
that fnct is decimal. 



The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 



4.9.4 IFop - COMPARE EXPRESSION VALUES 

An IFop pseudo instruction compares the values of two expressions according to the relational 
mnemonic specified and assembles instructions in the IF range when the comparison is satisfied. 

Format: 



IOCATION 


OPERATION 


VARIABLE SUBFIELDS 


ifname 


IFop 


exp 1 ,exp 2 ,jenct 



ifname 
op 



Optional 1-8 character name. 
Specifies comparative test: 



op 
EQ 



NE 



GT 



GE 



LT 



Condition causing assembly 

Equality; the expressions are equal in all respects. That is, they 
not only have the same numeric value but have the same attributes 
as well. For example, both are names that are common 
relocatable, or absolute, or external, and so forth. 

Inequality; the expressions are not equal in all respects. They 
differ in value or in some attribute. 

The first expression is greater in value than the second expression. 
No other attributes are tested. 

The first expression is greater than or equal in value to the second 
expression. No other attributes are tested. 

The first expression is less in value than the second expression. 
No other attributes are tested. 
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exp. 



LE The first expression is less than or equal in value to the 

second expression. "No other attributes are tested. 
For these tests, positive zero and negative zero are equal. 

An expression. When the value of exp is tested, exp can include only previously 
defined symbols and the result can be absolute, relocatable, or external. If an 
undefined symbol is used, the expression value is set to zero, the IF instruction 
is flagged as erroneous, and assembly continues with the next instruction. 



^ nct Optional absolute evaluatable expression specifying an integer count of the 

number of statements to be skipped. When base is M, COMPASS assumes 
that fnct is decimal. When jjnct is blank, the comma can be omitted. 

The ifname and inct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that 
does not match has no effect. 

Example: 

A demonstration of one use of IF statements in a PPU program: 



LOCATION 



OPERATION VARIABLE 



II 



IFlT 
ZJN 
ELi>£ 
NJH 



COMMENTS 



130 



DEF,L0OP 

♦-Loop.^oa 

LOUP 
2 
* + 3 

LOOP 



This code assembles a zero jump to the symbol LOOP if LOOP has been defined within 37 g words (the 
range of n short jump) prior to the occurrence of this code. Otherwise, the NJN and LJM are assembled. 

4.9.5 IF -TEST SYMBOL OR EXPRESSION ATTRIBUTE 

The IF pseudo instruction tests a symbol or an expression for a specific attribute and assembles 
instructions in the IF range if the test is satisfied. 
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Format: 



LOCATION 



ifnarne 

ifname 
att 



OPERATION 



VAtlABLE SUtFlElOS 



IF att,exp,|nct 



Optional 1-8 character name 

Specifies attribute test. A minus prefix to the attribute causes assembly on 
the false rather than the true condition. 

a *t Condition causing assembly 

SET The symbol given in the second subfield was defined by a SET, 

MAX, MIN, or MICCNT 

-SET The symbol given in the second subfield was defined other than 

by a SET, MAX, MIN, or MICCNT 

ABS The expression in the second subfield reduces to a value that is 

not relocatable or external 

-ABS The expression in the second subfield reduces to either a 

relocatable or an external address 

REL The expression in the second subfield reduces to a local or 

common relocatable address 

-REL The expression in the second subfield does not reduce to a local 

or common relocatable address 

REG The expression in the second subfield contains one or more 

register names 

-REG The expression in the second subfield does not contain a register 

name 

COM The expression in the second subfield reduces to a common 

relocatable address 

-COM The expression in the second subfield is not a common 

relocatable address 

EXT The expression in the second subfield contains one or more 

external symbols 

-EXT The expression in the second subfield does not contain an 

external symbol 

LCM The expression reduces to an LCM address 

-LCM The expression does not reduce to an LCM address 

LOC The expression reduces to a program relocatable address 

-LOC The expression does not reduce to a program relocatable address 
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exp 



jtoct 



DEF 

-DEF 

MIC 
-MIC 
SST 
-SST 



All the symbols in the expression in the second subfield are 
defined 

One or more of the symbols in the expression in the second 
subfield is undefined 

The name in the second subfield is a micro 

The second subfield does not contain a micro name 

The second subfield does not contain a system symbol 

The second subfield contains a system symbol 



For SET, SST, -SET, and -SST, exp must be a single defined symbol. For 
MIC and -MIC, exp must be a name. For any other test, it is an expression. 
The expression can include symbols as yet undefined if att is DEF, -DEF, REG, 
-REG, EXT, or -EXT only. If an undefined symbol is used with any other 
attribute, the expression value is set to zero, the instruction is flagged as 
erroneous, and assembly continues with the next instruction. 

Optional absolute expression specifying an integer count of the number of 
statements to be skipped. When base is M, COMPASS assumes that fnct is 
decimal. When {net is blank, the comma can be omitted. 



The ifname and jfrict parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 

Examples 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


II 


18 |30 


• BLE 

• 
• 

TEST 

• 
• 

TEST 
OTA 


BSS 

• 
• 
• 

IF 

• 
• 
• 

ENOIF 
IF 

• 
• 

USE 
BSS 


20 [ 

1 

I 1 

REl,ABLE+i5 J 

1 

1 

* 

1 
COM, OTA, 2 ERRONEOUS, OTA AS YET UNOEFINED 

1 

. 1 

1 

" : 

i 
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4.9.6 IFC - COMPARE CHARACTER STRINGS 

The IFC pseudo instruction compares two character strings according to the operator specified 
and assembles instructions in the IF range it the comparison is satisfied. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


ifname 


IFC 


op, dstring 1 dstring 2 d, jfnct 



ifname 
d 

op 



string. 



Unci 



Optional 1-8 character name 

Delimiting character. Characters between the first and second occurrence of this 
character constitute the first character string; characters between the second and 
third occurrence constitute the second character string. 



Specifies comparative test: 

op 

EQ or -NE 

NE or -EQ 

GT or -LE 



GE or -LT 
IT or -GE 
LE or -GT 



Condition causing assembly 
string has the same value as string 
string d es not equal string- 
string is greater than string 

stringj i s greater than or equal to string- 
stringy is less than string 2 
stringy is less than or equal to strings 



Character string. When IFC is within a macro definition, each character string- 
can be a formal parameter. 

Optional absolute evaluatable expression specifying an integer count of the 
number of statements to be skipped. When base is M, COMPASS assumes 
that {net is decimal. When {net is blank, the comma can be omitted. 

The ifname and {net parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 
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Each character in strii^ is compared with the corresponding character in string 2 progressing from 
left to right until an inequality is found or both strings are exhausted. When one string is shorter than 
the other, it is padded with a character that has a value less than any other character in the string. 

The truth condition is based on the relative magnitudes of the characters in the strings. 

Examples : 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


16 i 30 




TESTi 
TEST2 
TEST3 


IFC 
IFC 
IFC 
IFC 


EQ,$ABC$ABC$ ABC EQUALS ABC 
LT,*AB»ABC» | AB IS LESS THAN ABC 
GT,XAXX A IS GREATER THAN NULL 
-GE,»Z»8»,3 | Z IS LESS THAN 8 



The IFC in the following example checks for an empty parameter string. 



LOCATION 



XX 

p 



OPERATION 



11 



MACRO 

IFC 

ERR 



ENDM 



COMMENTS 



Pl,P2 

EQ,"P2»,1 



FLAG ERROR 



The following example illustrates an invalidly terminated character string. The asterisk was omitted 
following PI causing an error flag when the comma is interpreted. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


16 1 30 






IFC 


EQ,*00^P1,2SP2 
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4.9.7 IFPL AND IFMI -TEST SIGN OF EXPRESSION 

The IFPL and IFMI pseudo instructions test the sign of an expression and assemble instructions in 
the IF range according to whether the sign of the value is plus (PL) or minus (MI). The pseudo 
instructions allow positive zero to be distinguished from negative zero. 



Format: 



LOCATION 


OPERATION 


if name 
ifhame 


IFPL 
IFMI 



ifname 
exp 



VAKIABIE SUBFIELDS 



exp.fnct 
exp.inct 



Optional 1-8 character name 



An expression. It can include only previously defined symbols and the result 
can be absolute, relocatable, or external. If an undefined symbol is used, the 
instruction is flagged as erroneous and assembly continues with the next 
instruction. 



fnct Optional absolute evaluatable expression specifying an integer count of the number 

of statements to be skipped. When base is M, COMPASS assumes that fnct is 
decimal. When jjnct is blank, the comma can be omitted. 

The ifname and fnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 

The condition tested for by IFPL is satisfied if the value of exp is greater than or equal to plus zero; 
the condition for IFMI is satisfied if the value of exp is less than or equal to minus zero. 
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Example: 

The following opdef defines the CPU instruction MXi jk so that the address value is 60 if the expression 
value is negative zero or a positive nonzero multiple of 60, otherwise it is the address expression 
value modulo 60. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 I 30 




MXd 


OPOEF 


REG, VAL 






LOCAL 


A 1 




A 


SET 


VAL | 




A 


SET 


A-A/60D*60o' 






IFPL 


A, 3 1 






IFEQ 


A, 0,3 , 






IFLE 


VAL, 0,1 






SKIP 


1 1 




A 


SET 


A+630 , 






VFO 


6/<»3B,3/REG,6/A 






EMOM 


1 

1 
1 



Example of call: 



Code Generated 

7777713 
7777713 



10 



43610 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


IB ho 






MX6 


-52 1 




t +000001 




SET -52 | 




+ 4-000001 




i 
SET + +000001 -+ +000001 /60D*60D 






IFPL 


+ +00000 1,3 1 






IFEO 


++000001,0,3 I 






IFLE 


-52,0,1 | 






SKIP 


i ! 




+ +000001 




SET ++000001+60D 






VFD 


6/43B,3/6,6/++000001 






EN DM 


I 
1 

1 
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4.9.8 SKIP - UNCONDITIONALLY SKIP CODE 

The SKIP instruction causes COMPASS to unconditionally skip the instructions in the SKIP range. 
It resembles an IF for which there is no true condition. 

Format 



LOCATION 



ifname 



OPEHATION 



SKIP 



VARIABLE SUBFIEIDS 



jtact 



ifname 
Jtnet 



Optional 1-8 character name 

Optional absolute evaluatable expression specifying an integer count of the 
number of statements to be skipped. When base is M, COMPASS assumes 
that {net is decimal. 



The ifname and jSnct parameters are related as follows: 

1. If a count is supplied, it takes precedence over any ENDIF but not over an ELSE. The only 
effect of an ENDIF in a count controlled sequence is to be included in the count. Skipping 
terminates when the count is exhausted or when an ELSE with a matching or blank name is 
encountered, whichever occurs first. 

2. If neither a count nor a name is supplied, the IF range is terminated by the first ENDIF or 
ELSE encountered, whether named or unnamed. 

3. If a name but no count is supplied, the IF range is terminated by an ENDIF or ELSE with a 
matching name or by an unnamed ENDIF or ELSE. An ENDIF or ELSE with a name that does 
not match has no effect. 

4.10 ERROR CONTROL 

The ERR and ERRxx pseudo instructions described in this section either conditionally or unconditionally 
set an error flag. 

4.10.1 ERR - UNCONDITIONALLY SET ERROR FLAG 

An ERR pseudo instruction produces an assembly error but does not affect other code. Usually, it is 
used in conjunction with a conditional assembly pseudo instruction to force an error into the assembly 
based on an assembly time test. One application is to use a test and ERR to detect illegal macro 
parameters. 
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Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


flag 


ERR 





flag 



A single alphanumeric character denoting the error type. The flag is placed 
in the listing to the left of the line for ERR. The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generation of the 
binary deck unless the D mode option is selected on the COMPASS control 
card. If no flag is specified, or the character is not one of those given in 
section 11. 7, COMPASS uses P. 



A variable field entry, if present, is ignored. 
Example: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 




NNN 
A 


HACRO 

IFEQ 

ERR 

• 
• 

ENOM 

• 
• 
• 

NNN , 


P1,P2,P3,P<J 
Pi.O | 

1 

• 
• 

1 
1 

• 

0,A,B,C 1 



4.10.2 ERRxx - CONDITIONALLY SET ERROR FLAG 

An ERRxx pseudo instruction produces an assembly error when a condition detected during the second 
pass of the assembler is true. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


flag 


ERRxx 


aexp 



flag 



A single alphanumeric character denoting the error type. The flag is placed 
in the listing to the left of the line for ERR. The flag can denote a fatal or 
nonfatal error. A fatal error causes COMPASS to suppress generation of the 
binary deck unless the D mode option is selected on the COMPASS control card. 
If no flag is specified, or the character is not one of those given in section 11. 7, 
COMPASS uses P. 
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XX 



Defines condition under which aexp value is erroneous. 



xx 

NG 
NZ 
PL 
ZR 



Error Condition 
Value of expression is negative 
Value of expression is nonzero 
Value of expression is positive 
Value of expression is zero 



aexp 



Absolute expression. It cannot contain external symbols or references to blank 
common. The test is made in pass two of the assembler. Relocatable addresses 
are assigned values relative to program origin rather than to the block in which 
they are defined. 

NOTE 

ERRxx is the only conditional instruction for which the 
test is made in pass two. Therefore, this is the only 
pseudo instruction that can be used to determine PPU 
overflow if the PPU program has literals and USE 
blocks. 



Example: 

Test for memory overflow in PPU assembly 
Location Code Generated 



7HH7 
7*62 



7777«*7 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 |30 




LASTTAG 
R 


PERIPH 

• 
• 

BSS 

ERRPL 

ENO 


1 

i 

LASTTAG-7777J 

1 



4.11 LISTING CONTROL 

The instructions described in this section permit extensive control of the assembly listing format. 

4.11 .1 LIST - SELECT LIST OPTIONS 

The LIST pseudo instruction controls the content and format of the assembler listing. LIST instructions 
are disabled under either of the following conditions: 

When the list parameter (L) on the COMPASS control card (section 10.1. 2) is zero, or 
When the list option parameter (LO) is used on the COMPASS control card. 
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Use of the LIST pseudo instruction is optional. If it is not used in the subprogram, COMPASS list 
output is according to the L and LO parameters on the COMPASS control card. If the LO parameter 
is omitted or LO 0, the list options are as if L, B, N, and R only are selected and the listing contains 
heading information, assembly text, assembler statistics, an error directory (upon occurrence of an 
error only), and a symbolic reference table. Formats of this output are described in detail in 
chapter 11 and brief summaries are given below. 



Heading information 



Program length, origin, and length of each block, entry points 
and external symbols. 



Assembly text 



Line, and assembly results of each line assembled (not skipped) 
from the input device (excludes code generated by RMT, DUP, 
ECHO, XTEXT, or a macro or opdef expansion). For data 
generating pseudo instructions DATA, DIS, BSSZ that produce 
more than one word of object code, only the first word is listed. 
For VFD and CON, all words of object code are listed. For R=, 
only the pseudo instruction is listed. 

Each occurrence of the LIST instruction is listed. 



Assembler statistics 



Amount of storage used, counts of assembled statements, 
defined symbols, invented symbols, and references to symbols. 



Krror directory 
Symbolic reference table 



Lists fatal and nonfatal errors and summarizes the causes of each. 

List of all symbols defined in the program according to symbol 
qualifier, if any, followed by an index to every reference to the 
symbol in the listed statements. 



Formats: 



tOCATION 


OPE8ATION 


VARIABLE SUBF1EIDS 




LIST 

or 

LIST 


oPj.op 2> ...,op n 

* 



A location field symbol, if present, is ignored. 



op. 



A list option represented by a single letter or a letter prefixed 
by a minus sign. The unprefixed letter selects the option; the 
prefixed letter cancels the option. Options are separated by 
commas and terminated by a blank. 

A List statements actually assembled 

When A is not selected, a line containing concatenation 
and micro substitution marks is listed with the marks in it 
exactly as presented to the assembler. When the A option 
is selected, however, the assembler lists the line before and 
after the editing takes place. Selecting A also causes the 
listing of lines of code resulting from the R= pseudo instruction. 
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B List binary control statements 

When B is selected, the listing includes SEG, SEGMENT, IDENT, and 
END pseudo instructions. 

C List listing control statements 

When C is selected, the listing includes EJECT, SPACE, TTL, and 
TITLE pseudo instructions. A listing instruction that causes an EJECT 
is listed as the first line of the new page after the EJECT takes place 

D Include details 

Selection of the D option causes listing of the following items not normally 
listed: 

Second and subsequent lines of DATA and DIS 

Code assembled remotely when HERE or END causes its assembly 

Literals block 

Default symbols 

E Include echoed lines 

Selection of E causes listing of all iterations of code duplicated as a result 
of DUP and ECHO. 

F List IF-skipped lines 

When F is selected, the listing includes all lines skipped by IF, IFop, 
IFC, IFPP, IFCP, SKIP, and ELSE. In addition, the Symbolic Reference 
Table contains references to symbols in IF statements. 

G List generated code 

Selection of this option causes listing of all code generating lines regardless 
of list controls other than L. Instructions listed include symbolic machine 
instructions and BSS, BSSZ, CON, DATA, DIS, R=, and VFD. 

L Master list control 

This option is normally selected. When L is canceled, the long list contains 
error- flagged lines, an error directory, and LIST pseudo instructions only, 
regardless of selection of any other options on LIST. 

M List macros and opdefs 

Selection of M causes all lines generated by calls to macros and opdefs other 
than those defined by the system to be listed. 
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N List non-referenced symbols 

This option is normally selected. Cancellation of this option causes 
any non-system symbol for which no reference has been accumulated 
(e.g. , all occurrences are in IF statements with the F option deselected, 
or are between CTEXT or ENDX with the X option deselected ) to be 
omitted from the symbolic reference table. 

R Accumulate and List references 

This option is normally selected. When R is canceled, COMPASS does 
not accumulate references. R should not be canceled if a complete 
symbolic reference table is desired. If R is canceled at assembly end, no 
symbolic reference table is produced. 

S List systems macros and opdefs 

Selection of S causes all lines generated by calls to systems- defined 
macros and opdefs to be listed. 

T List non- referenced system symbols 

Selection of this option causes a symbol defined through SST to be 
included in the symbolic reference table even if there are no accumu- 
lated references. 

X List XTEXT lines 

Selection of the X option causes listing of all statements assembled as a 
result of an XTEXT pseudo instruction. CTEXT and ENDX provide a means 
of alternately turning this external designator off and on. 

An asterisk in the variable field causes selection of the options specified by 
the previous LIST pseudo instruction. Two or more consecutive LIST * 
instructions produce the same results as one LIST *. 

For list options A, C, D, E, F, M, S, and X, all applicable options must be selected for a specific 
line to be listed. For example, listing of an expansion resulting from a DUP within a macro requires 
selection of both M and E. Similarly, an expansion causes by an XTEXT within a system macro call 
is listed only when both X and S are selected. To obtain a listing showing r* and ^ marks removed from 
external text inside a DUP range requires that A, X, and E all be selected. 



Example : 



17205Ht63i^63i<f63i«t6 



2 172051A631A63H»631A6 

3 16<fQ31A631«t63Ht631<»6 

<♦ 172Q51A631<f631A63Ht6 



6 172051'f631<*631A63i<»6 

7 16<»031<t631'f631'»631<t6 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


30 






LIST 


A 








DATA 


i.3i*EE 








DATA 


1.3EE 








LIST 


D 








DATA 


1.3i»EE 








DATA 


1.3EE 








LIST 


-A,-D 








DATA 


1.3fE£ 








LIST 


* 








DATA 


1.3-EE** 








DATA 


1.3EE 
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4.11.2 EJECT— EJECT PAGE AND BEGIN NEW SUB-TITLE 

The EJECT pseudo instruction advances printer paper to a new page before printing. Then, page 
headings are printed and listing continues. 

Format: 



LOCATION 



OPERATION 



VARIABLE SUBFIELDS 



name 



EJECT 



name 



New program sub-subtitle for the page will be printed in character positions 
70-79 of the second line of the page. A blank name clears the sub-subtitle. 



An entry in the variable field, if present, is ignored. 



4.11.3 SPACE -SKIP LINES AND BEGIN NEW SUB-TITLE 



The SPACE pseudo instruction spaces the assembler listing. When a page is full, an eject occurs and 
listing resumes on the next page. A SPACE immediately following an EJECT is ignored. 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


name 


SPACE 


sent, rent 



name 



New subprogram sub-subtitle will be printed in characters 70-79 on the second 
line of the next page heading. A blank name clears the sub-subtitle. 



sent 



An absolute expression specifying a positive integer number of spaces between 
the most recent line and the next line of printout. If base is M, sent is assumed 
to be decimal. If sent is omitted or zero, no line is skipped. 



rent An absolute expression specifying a positive integer number of lines that must 

be remaining on the page following spacing. If base is M, rent is assumed to 
be decimal. 

If sent + rent exceeds the number of lines on the page before spacing occurs, the SPACE acts like an 
EJECT. Note that either the eject occurs or the number of spaces are skipped but not both. 

Blank cards can also be used to space the listing. 
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4.1 1 .4 TITLE - ASSEMBLY LISTING TITLE 

The first TITLE pseudo instruction establishes the title that will be printed on each page of the listing. 
A subsequent TITLE instruction generates a subtitle and causes a page eject. If the subprogram does not 
include a TITLE instruction, COMPASS prints the variable field of the first IDENT pseudo instruction 
as the title. A TITLE instruction without a character string produces an untitled listing. A name in 
the location field introduces a new subprogram sub-subtitle. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


name 


TITLE 


string 



name 



New subprogram sub-subtitle to be printed in character positions 70-79 
on the second line of the page. A blank name clears the sub-subtitlei 



string 



COMPASS searches the columns following the blank that terminates the 
operation field. If it does not find a nonblank character before the default 
comments column (see COL pseudo instruction), it takes the characters 
starting with the default comments column minus one, up to the end of the 
statement. Otherwise, the title or subtitle begins with the first nonblank 
character following TITLE and continues to the end of the statement or to 
62 characters. Any characters beyond the 62nd are lost. A blank string 
produces an untitled listing. 



Example: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 bo 














IUENT 

LIST 

TITLE 

• 
• 

TITLE 

• 
• 
• 


MTD | 
C i 
MT DRIVER I 

I/O ROUTINES) 

1 



First page: 



MT ORIVER 



Subsequent pages: 



MT DRIVER 
I/O ROUTINES 
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4.11.5 TTL-NEW ASSEMBLY LISTING TITLE 

The TTL pseudo instruction introduces a new main title to be printed on each page of the listing, and 
clears the subtitle. 

Format: 



LOCATION 



name 



OPERATION 



TTL 



VARIABLE SUBflELDS 



string 



string 



name 



COMPASS searches the columns following the blank that terminates the 
operating field. If it does not find a nonblank character before the default 
comments column (see COL pseudo instruction), it takes the characters 
starting with the default comments column minus one, up to the statement 
end. Otherwise, the title begins with the first nonblank character follow- 
ing TTL and continues to the end of the statement or to the 62nd character. 
Any characters beyond the 62nd are lost. A blank string produces an 
untitled listing. 

New sub-subtitle to be printed in character positions 70-79 on the second 
line of the pages. A blank name clears the sub-subtitle. 



TTL does not cause a page eject. 



4.11.6 NOREF-OMIT SYMBOL REFERENCES 



The NOREF pseudo instruction causes the symbols named in the variable field to be suppressed from 
the symbolic reference table. 

Format: 



LOCATION 



OPERATION 



NOREF 



VARIABLE SUBFIELDS 



sym 1 ,sym 2 ,...,sym n 



sym. 



l 



One or more symbols defined in the subprogram. If a symbol qualifier is in 
effect when the NOREF is encountered, the symbols are assumed to be qualified 
by the qualifier in use. Alternatively, sym. can be a non-blank qualifier symbol 
enclosed by slant bars, /qualifier/, in which case all symbols qualified by the 
specified qualifier are suppressed from the sumbolic reference table. 



A location field symbol, if present, is ignored. 
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4.11.7 CTEXT AND ENDX - DISABLE/ENABLE LISTING OF COMMON DECK TEXT 

The CTEXT pseudo instruction sets the XTEXT flag for list control. 

NOTE 

When the flag is set, external text is listed only if 
the X list option is selected. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


name 


CTEXT 


string 



name If X list option is selected, name (optional) is treated as a sub subtitle; 

otherwise it is ignored. 

string If the variable field is nonblank and the X list option is selected, the CTEXT 

is treated as a subtitle. The CTEXT instruction generates a subtitle and 
causes a page eject. If X is not selected, the CTEXT does not affect titling. 

The subtitle begins with the first nonblank character following CTEXT 

and continues to the end of the statement or to 62 characters. Any characters 

beyond the 62nd are lost. 

The ENDX pseudo instruction clears the XTEXT flag for list control and causes listing to resume, 
starting with the instruction after ENDX, ^hen the X list option has not been selected. 

Format: 



LOCATION 



OPERATION 



VARIABLE SUBFIRDS 



ENDX 



Entries in the location field or variable field, if present, are ignored. 
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4.11.8 XREF— REFERENCE SYMBOLIC ADDRESS 

The XREF pseudo instruction provides the options of having the symbolic reference table contain 
references to symbols according to 1) location counter address, 2) page and line number, or 
3) both. For the format of the symbolic reference table, refer to section 11. 8. 

Format: 



LOCATION 


OPERATION 


VARIABLE SU6FIEIDS 




XREF 


string 



string 



An optional character string, the first character of which indicates how symbols 
are to be referenced. 

A The symbolic reference table lists addresses only. Flags are not included. 

B The symbolic reference table lists references to symbols according to 
page number, line, and address. Flags are included. 



A location field symbol, if present, is ignored. 

If the string is omitted or if no XREF is issued, the symbolic reference table contains references 
according to page and line numbers and includes flags. The last XREF encountered in a subprogram 
determines the form of the listing for the entire subprogram. 
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DEFINITION OPERATIONS 



This chapter describes pseudo instructions that involve definition operations. These pseudo 
instructions cause sequences of instructions to be saved for these reasons: 

They can be assembled from an external source (XTEXT). 

Assembly can be delayed until later in the subprogram (RMT). 

They can be assembled repeatedly (DUP and ECHO). 

They can be referred to for assembly (MACRO, MACROE or OPDEF). 

Any instructions other than END, including other' definitions or calls, can be in the body of a definition. 

Each request for assembly of one of the saved sequences of code, such as a reference to a macro, 
causes an entry in the assembler recursion stack. The most recent entry in the stack points to the 
source of statements (the definition) to be assembled. When the definition contains an inner, nested, 
reference to a saved definition, the stack pointer is changed so that the source of statements is the 
innermost definition. The stack allows nesting of definitions to a maximum level of 400. When the 
end of a definition is reached, the assembler switches to the preceding entry in the stack. When the 
stack is empty, the assembler resumes assembly of the next statement in the input source deck. 
A nested definition must be wholly contained by its next outer definition. 

Definitions are saved compressed but otherwise unedited (with micro and concatenation marks). Editing 
occurs each time the definition is processed. Compression removes blanks and replaces them with 
coded bytes as follows : 

A single space is represented by 55 g ; it is not compressed. Two or more embedded spaces are 
replaced in the image as follows: 

2 spaces replaced by 5555 

3 spaces replaced by 0002 

4 spaces replaced by 0003 



64 spaces replaced by 0077g 

65 spaces replaced by 007755 g 

66 spaces replaced by 00775555- 

67 spaces replaced by 00770002 etc. 

8 

Trailing spaces are considered as embedded and are included in the image. The 00 character 
(colon) is represented by the 12-bit code 0001. A 12-bit zero byte marks the end of the statement. 

The listing identifies the source of statements and the recursion level for all definition operations. 
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For XTEXT, DUP, and ECHO, assembly occurs as soon as a definition is saved. Unless the definition 
contains a USE, USELCM, or ORG instruction, code is assembled into the block in use when the 
XTEXT, DUP, or ECHO is encountered. For RMT, macros, and opdefs, however, definition and 
assembly take place in two steps. The block in use at definition time does not determine where code 
in the definition will be assembled. That is, code is assembled into the block in use when the definition 
is assembled if the definition does not itself contain a USE, USELCM, or ORG. 

Similarly, for XTEXT, DUP, and ECHO, any qualifier in effect when the pseudo instruction is 
encountered applies to symbols defined in the sequence (assuming the sequence does not contain a 
QUAL). For RMT, macros, and opdefs, however, because definition and assembly take place in two 
steps, the qualifier in use at definition time does not affect symbols in the definition. The qualifier, 
if any, in effect when the definition is assembled is applied to the symbols defined in the sequence. 

A qualifier applies to symbols only. It does not apply to block names or to the names of DUP, ECHO, 
RMT, or macro definitions, nor to any substitutable parameter names. 

In definitions having substitutable parameters, it is possible to use a different block name, different 
qualifier, or different symbols with each expansion simply by declaring either the qualifier symbol, 
block name, or symbols to be qualified as substitutable parameters. (For an example, refer to 
example 7 under Macro Call. ) 

5.1 EXTERNAL TEXT (XTEXT) 

The XTEXT pseudo instruction provides a means of obtaining source statements from a file other than 
that being used for input. COMPASS transfers the text from the external source and assembles it 
before taking the next statement from the interrupted source of statements. The file may be a sequential 
file, an indexed file with named records, or an UPDATE or MODIFY f random-access program library 
file. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


file 


XTEXT 


rname 



t SCOPE 2 does not support MODIFY format. 
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file 



rname 



Name of a file containing source statements. If file is omitted, COMPASS 
assumes the file named in the X parameter on the COMPASS control card 
(section 10.1.2). If no X parameter was specified, COMPASS assumes OLDPL. 

If rname is blank, COMPASS assumes that the file is sequential; it rewinds 
the file and reads the first logical record. If rname is not blank, it is the name 
of the record to be read. The file must be an indexed file with named records, 
a random-access program library file in UPDATE format, a random-access 
program library file in MODIFY f format, or a random access text record. 



Text records may be in any of the following formats. 

1. Normal text. If the first line contains rname starting in column 1, it is skipped. 

2. A common deck in a random-access program library file. If the file is in UPDATE format, 
the first line (*COMDECK rname) is always skipped. If the file is in MODIFY format f, the 
record may be a COMMON deck or a text record. 

COMPASS reads source statements to an end-of-record mark or an END pseudo instruction. 



5.2 REMOTE ASSEMBLY 

Definition and assembly of remote code takes place in two steps. A pair of RMT pseudo instructions 
delimit code that is to be saved for later assembly. Later, a HERE pseudo instruction directs 
COMPASS to assemble a specific sequence of remote code or to assemble all unlabeled remote code. 
An END instruction causes any unlabeled remote code to be assembled. 

5.2.1 RMT -SAVE REMOTE CODE 

A RMT pseudo instruction signals the beginning or the end of a sequence of code to be assembled 
remotely. 

Format: 



LOCATION 



rmtname 



OPERATION 



RMT 



VARIABLE SUBf-IELDS 



rmtname 



Optional 1-8 character name identifying the remote sequence. It is 
significant on the beginning RMT only. The field is ignored for a terminating 
RMT. If supplied, rmtname can be used on a subsequent labeled HERE. 
If the sequence is unlabeled, an unlabeled HERE or END causes its assembly. 



A variable field entry, if present, is ignored. 



tSCOPE 2 does not support MODIFY format. 
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Any instruction legal when the remote lines are called for assembly is legal between the RMT pair. 
If expansion of an RMT reveals a second RMT pair implicit to the saved definition, assembly of the 
first pair must occur through a HERE instruction so that the inner pair will be expanded by an END. 
Similarly, if the assembly of the second pair reveals yet a third RMT pair, the second pair must be 
assembled through a HERE rather than the END, etc. 

Any labeled remote code present when END is processed is discarded without notice. 

5.2.2 HERE - ASSEMBLE REMOTE CODE 

A HERE pseudo instruction causes the labeled remote sequence to be assembled or unlabeled saved 
remote sequences to be assembled. In the absence of a USE, USELCM, IDENT, or an ORG within 
the saved sequence, the remote code is assembled under the block in use at the time the HERE is 
encountered. In the absence of a QUAL within the saved sequence, symbols are qualified under the 
qualifier in use at the time the HERE is encountered. RMT code is assembled only once. After it 
is assembled, it is no longer saved. A HERE encountered when there is no remote text saved has no 
effect on assembly. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


rmtname 


HERE 





rmtname 



Optional; the name of a previously saved RMT sequence, 
sequence will be assembled at this time. 



Only the named 



A variable field entry, if present, is ignored. 

If unlabeled remote sequences still remain to be assembled when the END card signaling the end of 
assembly is encountered, COMPASS assembles them before it terminates assembly. However, any 
RMT pairs that might have resulted from the assembly are lost. Also, any remaining labeled remote 
code is lost. 

Examples: 

The following example illustrates use of RMT within a macro definition. Following the last call to 
the macro, a HERE causes all saved unlabeled RMT sequences to be assembled. 
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Location 



Code Generated 



4727 

1331 
4727 00000000000000032304 



<«73Q 

1332 
4730 00000000000000032304 



4731 



1332 
4730 



4672 
4673 
4673 



LOCATION 



INAM 
O.TNAM 

TNAM 
O.TNAM 



L.TNAM 



INTER 

INTER 
0. INTER 



L. INTER 



LASTAB 

LASTAB 
0. LASTAB 



L. LASTAB 



NRTAB 



NRTAB 
0. NRTAB 



L. NRTAB 



OPERATION 



L. INTER 
L. LASTAB 
L. NRTAB 



MACRO 

IFC 

EQU 

CON 

ELSE 

EQJ 

EQU 

RMT 
EQU 
RMT 



ENOM 



TABLE 

IFC 
EQU 
CON 

ELSE 

RMT 

EQU 
RMT 
ENOM 
TABLE 
IFC 
EQU 
CON 
ELSE 

RMT 

EQU 
RMT 
ENOM 
TABLE 
IFC 
ELSE 
EQU 
EQU 

RHT 

EQU 
RMT 
EN3M 



HERE 
EQU 

EQU 
EQU 



VARIABLE 



COMMENTS 



TABLE, TNAM, EQIV 

EQ,»*EQIV* 

•-ORIGINS 

BUCKET 

2 

EQIV 

O.EQIV 



TNAM+SIZES 



EQ,»»* 

♦-ORIGINS 

BUCKET 
2 



INTER+SIZES 



EQ,"* 

♦-ORIGINS 

BUCKET 
2 



LASTAB+SIZES 



LASTAB 

EQ,"LASTAB^ 

2 

LASTAB 

O. LASTAB 



NRTAB+SIZES 



INTER+SIZES 

LAS1AB+SIZES 
NRTAB+SIZES 



TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 

TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 

TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TABLE 
TAOLE 
TABLE 



•RMT* 
♦RMT» 
♦RHT* 
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In the following example, assembly of the RMT sequence is caused by the END statement. 



1000D501Z 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


11 


18 (30 


FLO 

PRS 

FLO 
PRS 
PRS 


RMT 

OECMIC 
LIT 
RMT 

LIST 
OECMIC 
LIT 
LIT 


( 

1 

BUF+8UFL-WSA+EN0S 

C**FLD* DECIMAL REQUIRED.' 

1 

1 
C i 
BUF+BUFL-WSA+FNOS *RMT» 
C»*FLD* DECIMAL REQUIRED.' *RHT» 
C»25759 OECIMAL REQUIRED.* »RHT* 



5.3 CODE DUPLICATION 

This section describes two pseudo instructions (DUP and ECHO) that cause a sequence of code to be 
assembled repeatedly. For a DUP sequence, each assembly is identical with the first, and the 
number of repetitions is specified or is indefinite. For an ECHO sequence, each assembly resembles 
a macro reference. Actual parameters supplied in a list are substituted for formal parameters on 
each repetition of the code sequence. The number of repetitions is determined by the number of 
actual parameters provided on the ECHO instruction. 

Every inner DUP or ECHO sequence must lie totally within the range of the next outer DUP or ECHO, 
or a fatal E error is flagged. 

5.3.1 DUP - SIMPLE DUPLICATION 

The DUP pseudo instruction specifies repeated assembly of the statements immediately following. 
The range of the DUP is specified either by a source statement count on the DUP instruction or by an 
ENDD. 
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Format: 



LOCATION 


OPERATION 


VARIABLE SUSFIEIDS 


dupname 


DUP 


rep.jfnct 



dupname 



rep 



fnct 



Optional name of the DUP sequence; 1-8 characters. When supplied, it can be 
used in an ENDD. When no name is supplied, the range of the DUP is determined 
by a statement count or by any ENDD. 

Absolute evaluatable expression specifying the integer number of times state- 
ments in the DUP range are to be assembled. If rep is null or zero, the 
instructions in the range are not assembled; that is, code is skipped. When 
base is M, COMPASS assumes that rep is decimal. 

NOTE 

A very large (unobtainable) repeat count in conjunction with a 
STOPDUP instruction can be used for indefinite duplication 
of code. 

An evaluatable expression specifying an integer count of the number of 
statements to be assembled repeatedly. When base mode is M, COMPASS 
assumes that jfrict is decimal. The count is decremented for statements only; 
comment lines (identified by * in column one) are not counted. On each 
iteration, the assembler copies the source statements and then assembles 
them. Thus, any recursive statements within the sequence are counted 
before they are expanded. 



The dupname and £nct parameters are related. 

1. If a count is supplied, it takes precedence over any ENDD. The only effect of an ENDD is to 
be included in the count. Under count control, a name is irrelevant. 

2. If neither a count nor a name is supplied, the DUP range is terminated only by an unnamed 
ENDD. 

3. If a name but no count is supplied, the DUP range is terminated by an ENDD with a matching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not effect the 
range. 

5.3.2 ECHO - ECHOED DUPLICATION 

The ECHO instruction specifies repeated assembly of the instructions immediately following. On each 
iteration, the assembler copies the source statements substituting an actual parameter in the list for 
each formal parameter until the shortest list is exhausted, and then assembles the statements. ECHO 
offers many of the features of macros but does not require separate definition and reference. The 
range of the ECHO instruction is specified either by a source statement count specified on the ECHO 
instruction, or by an ENDD. The statement count, when used, is decremented for instructions only; 
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comment lines, identified by * in column one, are not part of the definition and are not counted. 
Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


dupname 


ECHO 


jfnct,p 1 =(list 1 ),p 2 =(list 2 ),...,p n =(list n ) 



dupname Optional name of the ECHO sequence; 1-P characters. When supplied, 

it can be used in an ENDD. When no nan, : *■ supplied, the range of the 
ECHO is determined by a statement count or by any ENDD. 

toct Optional absolute evaluatable expression specifying an integer count of the 

number of source statements to be assembled repeatedly. If base mode is 
M, the count is assumed to be decimal. If jjnct is zero or omitted, the comma 
must be present and the ECHO range is defined by an ENDD. 

Any recursive statements, such as macro references, are counted before 
they are expanded. 

If the count exceeds the range of an outer DUP or ECHO sequence, a fatal 
E error is flagged. 

The dupname and fnct parameters are related. 

1. If a count is supplied, it takes precedence over any ENDD. The only effect of an ENDD in a 
count- controlled sequence is for it to be included in the count. Under count control a name 
is irrelevant. 

2. If neither a count nor a name is supplied, the ECHO range is terminated only by an unnamed 
ENDD. 

3. If a name but no count is supplied, the ECHO range is terminated by an ENDD with a matching 
name or by an unnamed ENDD. An ENDD with a name that does not match does not terminate 
the sequence. 



P i 



Names of not more than 63 formal substitutable parameters. Each name is 1-8 
characters, the first of which must be alphabetic. A name cannot be END, 
LOCAL, ENDD, IRP, or ENDM. A second or later occurrence of a parameter 
name is ignored. A name that begins with a number is ignored. 

The separator between pj and (listj) is conventionally an = but can' be any of the 
following: 



/ ( 



or 



COMPASS recognizes a substitutable parameter name within a definition when it 
is between any two of the following: 

: +-*/()$= blank , . 4 or r- 

The substitutable parameter name can occur in any field within a definition. 
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Before the ECHO definition is stored, COMPASS replaces each use of a 
substitutable name. Otherwise, it saves the definition unedited, i. e. , with 
micro and concatenation marks. Use of the semicolon is restricted in the 
definition because the assembler, when it expands the definition, interprets it 
as a substitutable parameter flag (77 Q ). 

o 

The character <-*■ flags the occurrence of a name not bounded by any other 
special character and, thus, not otherwise recognized. When it expands the 
definition, COMPASS substitutes an actual parameter value from the list for 
the substitutable parameter and removes the r* so that the adjacent items are 
concatenated. 

Because the assembler replaces the first substitutable parameter with 7701, 
the second with 7702, etc. the programmer can use the display characters 
;A, ;B, etc. directly in place of his substitutable parameter names in the 
definition and achieve the same results as if the assembler had replaced the 
name with the flag. (Example 8, section 5. 4. 3 illustrates a similar application 
of this technique. ) 

Oist.) Actual parameter list in the form aj, a 2 , . . . , a where a. is substituted for p. 

on the first assembly of the ECHO sequence, a 2 is substituted on the second 
assembly, etc. until the shortest list is exhausted. Two consecutive commas 
are interpreted as a null parameter. An explicit zero, if desired, must be 
entered. An actual parameter can contain a set of embedded parameters 
enclosed by parentheses. However, the embedded parentheses must be 
properly paired. The assembler removes the outer pair of parentheses before 
substituting the embedded set in a line. A parenthetical item can contain blanks 
or commas. 

If there are no parameters or any of the lists are null, COMPASS assembles the 
ECHO sequence zero times, effectively skipping it. 

5.3.3 STOPDUP - STOP DUPLICATION 

The STOPDUP instruction allows premature termination of a DUP duplication before the repeat count 
is reached or of an ECHO duplication before the shortest list is exhausted. Assembly is completed to the 
end of the range for the current iteration and then continues with the next source statement. Only the 
innermost duplication is affected. 

A STOPDUP outside of a DUP or ECHO range has no effect on assembly. If DUP or ECHO is nested, 

STOPDUP terminates only the innermost DUP or ECHO. 

Format: 



LOCATION 



OPERATION 



VARIABLE SUBFIELDS 



STOPDUP 



An entry in the location or variable field is ignored. 
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5.3.4 ENDD - END DUPLICATION SEQUENCE 

The ENDD pseudo instruction terminates a DUP or ECHO sequence when the statement count is 
unspecified on the DUP or ECHO. 

Format: 



LOCATION 



OPERATION 



VARIABLE SUBFIELDS 



dupname 



ENDD 



dupname 



Name of a DUP or ECHO sequence, or blank, A named DUP or ECHO 
sequence can be terminated by an ENDD specifying the sequence by name, 
or by any unnamed ENDD. An unnamed DUP or ECHO sequence that is not 
controlled by statement count is terminated only by an unnamed ENDD. An 
ENDD does not terminate a sequence controlled by a statement count. The 
ENDD is included in the count but has no other effect. 



Examples : 



An ENDD outside the range of a DUP or ECHO has no effect on assembly. 



In the following examples, the statements that result from expansion are shown faded. They are 
listed only when the E list option is selected. Source statements are shown in bold characters. 

1. This example illustrates use of a simple DUP instruction. 



Location Code Generated 



009005 
Jiff lOttOOl 

,*m iti 

flf5 Ofll 

915S 081 

#1S7 Oil 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




1 




II 


.8 


30 






OUP 


5,1 








DATA 










DATA 




♦0Uf»» 


1 ; 




OATA 




»0UP» 


...:,!•' 




DATA 




♦QUI* 


:•■ t.j 




OATA 




•DUP* 


•i 






OATA 




♦OOP* 


• ,%K 
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This example illustrates a nested DUP instruction with one of the DUP duplications terminated 
by a STOPDUP. 



LOCATION 



GO 
TAG 



NO 

GO 

ALPHABET 

NO 



TAG 
TAG 



NO 



TAG 
TAG 



NO 



TAG 
TAG 



NO 



OPERATION 



VARIABLE 



COMMENTS 



MACRO 

MICRO 

IFC 

STOPDUP 

SFT 

ENDM 

MICRO 

SFT 

DUP 

GO 

ENDD 

GO 

MICRO 

MICRO 

IFC 

IFC 

STOPDUP 

SFT 

Enom 

ENDD 

GO 

MJCRO 

MICRO 

IFC 

IFC 

STOPDUP 

SFT 

Endm 

ENDD 



so 

MICRO 

MICRO 

IFC 

IFC 

STOPDUP 

SFT 

Endm 

ENDD 



NOO ./^ALPHABET*/ 

EQ»/*TAG*/E/,I ASSEMBLE STOPDUP WHEN TAG»E 



NO+l 



NO IS 6 IN LAST ITERATION 



1*»/ABCDEFGHIJK/ 

1 

-1 UNOBTAINABLE ITERATION COUNT 



NOiit/MLPMABET*/ 

N0.i,/A8CDEFGHIJK/ 

EQt/#TAG*/E/.l ASSEMBLE STOPDUP WHEN TAG«E 

E0,/A/F/,l ASSEMBLE STOPDUP WHEN TAG»E 



NO*] 



NO IS 6 IN LAST ITERATION 



NOtl./rfALPMABET*/' 

NOtlt/ABCDEPGHIJK/ 

EQt/#TAGX/E/ f l ASSEMBLE STOPDUP WHEN TAG»E 

EQt/B/F/tl ASSEMBLE STOPDUP WHEN TAG«E 



NO*1 



NO IS 6 IN LAST ITERATION 



NOt) »/*ALPHaBET#/ 

NOti,/ABCDEFGHIJK/ 

EQi/#TA6*/E/.l ASSEMBLE STOPDUP WHEN TAG«E 

EQ»/E/f/»l ASSEMBLE STOPDUP WHEN TAG»E 



NO*] 



NO IS 6 IN LAST ITERATION 



•DUP* 

GO 

GO 

GO 

GO 

GO 

GO 

GO 

♦DUP* 

•DUP* 

GO 

GO 

GO 

GO 

GO 

GO 

GO 

•DUP* 



•OUP* 

60 

GO 

GO 

GO 

GO 

GO 

GO 

*OUP* 
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This example illustrates nested ECHO instructions, 
level ECHO. The ENDD terminates the first level, 
copy before it begins the next iteration. 



A statement count terminates the second 
Notice how COMPASS assembles each 



Location 



Code Gene rate d 



1452 


1450 




1453 


5415 


0036 


1455 


1450 




1456 


5415 


0037 


1460 


1450 




1*61 


5415 


0040 



1463 


1460 




1464 


5415 


0036 


1466 


1460 




1467 


5415 


0037 


1471 


1460 




1472 


5415 


0040 



1474 


1470 




1475 


5415 


0036 


1477 


1470 




1500 


5415 


0037 


1502 


1470 




1503 


5415 


0040 


1505 


5415 


152«» 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 




i 




II 


,8 


30 






PPU 

• 










STM 


• 
• 

PPOP 

LIST 

ECHO 

ECHO 

LUN 

STM 

ENUU 


5,5415B 

M,D,E 

,CM=(X,Y,Z> 

2,P1=(A,B,C) 

CM 

PI 










ECHO 


2,P1=CA,B,C> 


•ECHO* 


1 






LDN 


X 


♦ECHO* 


1 






STM 


PI 


♦ECHO* 


1 






LDN 


X 


♦ECHO* 


2 






STM 


A 


♦ECHO* 


2 






LDN 


X 


♦ECHO* 


2 






STM 


B 


♦ECHO* 


2 






LUN 


X 


♦ECHO* 


2 






STM 


C 


♦ECHO* 


2 






ENOO 




♦ECHO^ 


1 






ECHO 


2,P1=<A,B,C> 


♦ECHO* 


1 






LUN 


Y 


♦ECHO^ 


1 






STM 


PI 


♦ECHO^ 


1 






LON 


Y 


♦ECHO^ 


2 






STM 


A 


♦ECHO^ 


2 






LON 


Y 


♦ECHO^ 


2 






STM 


B 


♦ECHO* 


2 






LDN 


Y 


♦ECHO* 


2 






STM 


C 


♦ECHO* 


2 






ENOO 




♦ECHO* 


1 






ECHO 


2,P1=(A,B,C> 


♦ECHO* 


1 






LON 


Z 


*ECHO* 


1 






STM 


PI 


♦ECHO* 


1 






LON 


Z 


*ECHO* 


2 






STM 


A 


♦ECHO* 


2 






LDN 


Z 


♦ECHO* 


2 






STM 


B 


♦ECHO* 


2 






LDN 


Z 


*ECHO* 


2 






STM 


C 


♦ECHO + 


2 






ENDO 




♦ECHO^ 


1 






STM 


TAG 
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5.4 MACROS AND OPDEFS 

A macro or opdef definition is a sequence of source statements that are saved and then assembled 
whenever needed through a macro or opdef call. A macro call consists of the occurrence of the 
macro name in the operation field of a statement. It usually includes parameters to be substituted 
for formal parameters in the macro code sequence so that code generated can vary with each assembly 
of the definition. 

An opdef call differs from a macro call in that the assembler interprets the call by examining the 
format or syntax of the instruction rather than the contents of the operation field alone. The instruction 
comprising the opdef call usually includes parameters to be substituted for parameters in the code 
sequence. There are some differences in the way parameters are substituted, however, as is further 
described under Opdef Call. 

Use of a macro or an opdef requires two steps, definition of the macro or opdef sequence, and calling 
of the definition. 

A definition consists of three parts: heading, body, and terminator. 



Heading 



A macro definition is headed by a MACRO or MACROE pseudo instruction 
stating the name of the macro and identifying substitutable parameters in 
the body of the macro. 



Body 



An opdef definition is headed by an OPDEF pseudo instruction stating the syntax 
of the calling instruction and identifying substitutable parameters in the body of 
the macro. 

The heading optionally includes one or more LOCAL instructions identifying 
symbols local to the definition. 

The body begins with the first statement in a definition that is not a LOCAL 
statement or a comment line. A comment line can be either identified by * 
in column one or can have columns 1-29 blank. (Following the first statement 
of the macro body, only comments identified by * in column 1 are ignored. ) 

Use of the semicolon is restricted because when a definition is expanded a 
semicolon is interpreted as a substitutable parameter mark or a local symbol 
flag. 

The body consists of a series of symbolic instructions. All instructions other 
than END, including other macro and opdef definitions and calls are legal within 
a definition. However, a definition within a definition is not defined until the 
outer definition is called. Therefore, an inner definition cannot be called before 
the outer definition is called. 

A name of a substitutable parameter listed in the heading can occur in any field 
within the body. A reference to a substitutable parameter is recognized when it 
is between two of the following characters in an expression or field: 

: +-*/()$= blank , . / or r 

The character p- flags the occurrence of a name not bounded by any other special 
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character, and, thus, not otherwise recognized. On a call, the assembler 
substitutes an actual parameter value for the substitutable parameter and 
removes the |— * so that the adjacent items are concatenated. 

NOTE 

The programmer can legally use the characters . ( ) : 
$ and = in symbols but when he does, he must be careful 
that these characters are not interpreted as delimiters in 
macro definitions (example 4 under macro calls). 

The macro body optionally contains IRP pseudo instructions that allow iterative 
assembly of a sequence within the body such that each iteration uses a different 
parameter value. 



Terminator 

Definition 
Processing 



An ENDM pseudo instruction terminates a macro or opdef definition. 



A macro or opdef can be defined anywhere in a subprogram before it is called. 
When COMPASS encounters a definition, it places the name of the macro or the 
syntax of the opdef along with the number of substitutable parameters and local 
symbols in the assembler operation code table. Before the definition is saved, 
COMPASS replaces each occurrence of a parameter name or local symbol with 
a 77xx (where xx is a number assigned to the substitutable parameter or local 
symbol). 

On the call, each use of a substitutable parameter (each 77xx) is replaced by 
its actual parameter; each use of a local symbol is replaced by a unique symbol 
generated by the assembler. Usually, symbols replaced in this way have no 
meaning outside the definition. However, if the macro includes an RMT 
sequence which contains local symbols, the local symbols will have meaning 
where the remote code is assembled outside of the definition. 



5.4.1 ENDM -END MACRO DEFINITION 

An ENDM terminates a macro or opdef definition. 
Format: 



OPERATION 



VARIABLE SUBFIEIDS 



mname 



ENDM 



mname 



Name of a macro sequence, syntax of an OPDEF sequence, or blank. 
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An ENDM specifying a macro by name terminates the named macro definition and any unterminated 
macro or opdef definitions within it. An unnamed ENDM terminates all unterminated definitions. 
An ENDM outside the range of any macro sequence has no effect other than to be included in statement 
counts. 

Example: 



LOCATION 



OPERATION 



VARIABLE 



COMMENTS 



JAY 



KAY 



JPX/XQ 



KAY 



MACRO 



MACROE 



OPDEF 



ENDM 



ENDM 



P1,P2,P3 



PK2,PK2,PK3^ 



0Pi,0P2,0P3 



PK«» 



TERMINATES KAY ANO 
THE OPDEF DEFINITION 



TERMINATES JAY 



5.4.2 MACRO - MACRO HEADING 

A MACRO pseudo instruction notifies the assembler to place the instructions forming the body of the 
macro in a table of macro definitions for assembly upon call and place the macro name in the operation 
code table. 

The MACRO pseudo instruction has two forms: 

Format one: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


mname 


MACRO 


parameters 
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Format two: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 




MACRO 


mname , parameter s 



The blank location field identifies the second format. 



mname 



parameters 



A legal name other than END, ENDD, IRP, LOCAL, or ENDM. 1-8 characters. 

A name that is identical to a PPU symbolic machine instruction, pseudo 
instruction, or macro already in the operation code table redefines the 
instruction. The most recent definition applies for the macro call. A 
redefinition causes an informative flag to be issued but the new definition 
holds. 

Names of substitutable parameters. The order in which names are listed 
determines the order in which parameters must occur in the macro call. Each 
name is 1-8 characters, the first of which must be alphabetic. A name cannot 
be END, IRP, LOCAL, ENDD or ENDM. A name that begins with a number, or 
a second or later occurrence of a parameter name in the list is ignored. 

Any of the following special characters separate parameters in the list: 

+ -*/()$=, or . 

These characters have no meaning other than as separators. A blank 
terminates the list of parameters. Also, any of these characters can be used 
to separate the mname from parameters in format two. 

The total number of unique parameter names and local symbols must not 
exceed 63 for any one macro definition. 

Format one does not require parameters. 

Format two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission of the location argument from a MACRO 
instruction in format two causes the assembler to issue a fatal error flag and 
ignore the definition. 

The assembler ignores a blank parameter produced by two concurrent 
separators or by a separator at the end of the list. 

For an example of definition and calls, refer to Macro Calls. 
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Examples of macro instructions: 
1. Legal MACRO instructions: 



LOCATION 



A8C 
MESSAGE 



OPERATION 



MACRO 
MACRO 
MACRO 



VARIABLE 



COMMENTS 



I 30 



P1,P2,P3 I 

OEF»LOC*ONE*TWO»TEN 
A I 



2. MACRO instructions having identical parameter lists. 



LOCATION 



SUM 
SUM 
SUM 
SUM 

RAO 
RAO 



OPERATION 



MACRO 
MACRO 
MACRO 
MACRO 

MACRO 
MACRO 



VARIABLE 



X=Y+Z*X 
X(Y+Z) 
XaY+Z 
X,Y,(Z*X> 

X 

X=X + 1 



COMMENTS 



SECOND X PARAMETER IS IGNORED 



NULL PARAMETER AND SECOND 
X ARE IGNORED 

SECONO X AND NUMERIC 
PARAMETER ARE IGNORED 



3. Illegal use of format two: 



LOCATION 



OPERATION 



MACRO 
MACRO 
MACRO 



VARIABLE 



ABC 

ABC,,FP 

ABCtl6»FP 



COMMENTS 

Tio 



NO SUBSTITUTABLE PARAMETER 
NULL PARAMETER FIELD 
NUMERIC PARAMETER FIELD 
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5.4.3 MACRO CALLS 

A macro headed by a MACRO pseudo instruction can be called by an instruction in the following format: 



LOCATION 


OPERATION 


VARIABLE SUBFIEIDS 


sym 


mname 


Pl»P2»---.P n 



sym Optional; depends on definition (see discussion following) 

Pi Parameter list composed of alphanumeric strings. Parameters are separated 

by commas and terminated by a blank. Two consecutive commas constitute 
a null parameter. An explicit zero, if desired, must be entered. 

Each parameter must be in its correct relative position depending on the sequence 
in which its formal substitutable name is given in the MACRO pseudo instruction. 

When the definition MACRO is in format one, the first parameter in the call is substituted wherever the 
first substitutable parameter occurs in the definition, the second parameter in the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. When the definition MACRO 
is in format two, the location field entry in the call is substituted wherever the first substitutable 
parameter occurs in the definition, the first parameter in the variable field of the call is substituted 
wherever the second substitutable parameter occurs in the definition, etc. 

If null parameters are interspersed with legal parameters, the correct positions must be established 
with commas. When the list terminates before the last possible parameter, all remaining parameters 
are considered null. 

When the first character of a parameter is a left parenthesis, the assembler considers all the 
characters between it and the matching right parenthesis as an embedded parameter or as an iterative 
parameter. It is an iterative parameter when the substitutable parameter has been named in an IRP 
pseudo instruction (section 5.4. 9). Otherwise, it is an embedded parameter. 

The assembler removes the outer pair of parentheses before substituting the enclosed character string 
in a line. Embedded parenthetical items must be properly paired. A parenthetical item can contain 
blanks and commas. 



Example: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 I 30 














MESSAGE 


1 

<=C*PROGRAMi ABORT.') 

i 



After substitution, spacing between fields is the same as it was before substitution. One effect is that 
a null actual parameter replacing a formal parameter in a variable field effectively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interpreted as 
a variable subfield. 
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Processing of a location symbol and forcing upper of the first macro instruction depend on the MACRO 
form used for the definition. 



If the macro is defined using format one, that is, the macro name is in the location field, a location 
symbol on the macro call line forces the first word of generated code upper. The location field symbol 
is assigned the current value of the location counter. A location field (if any) on the line in the 
definition that generates the code is assigned the same address. If the location field of the macro call 
does not contain a symbol, the location and position counters are not affected by the call. 

When the macro is defined using format two, that is, the macro name is in the variable field and the 
first parameter is a location argument, the location symbol of the call is substituted for the first 
parameter or location argument. The fact that this argument came from the location field rather than 
the variable field has no special significance in the macro expansion. In the macro call, the location 
field argument cannot be more than 8 characters, and parentheses are not given the special meaning 
used in the variable field of a macro call line. 

Example: 

1. An illustration of concatenation 



Location 



Code 
Generated 



'ffi&38&lt1S&ii&ffi& 



LOCATION 



WACK 



OPERATION 



MACRO 



FNDM 



«AtK 



ENDM 



VARIABLE 



COMMENTS 



130 



P1.P2 
Pl*lRfP2 



A?, A 

******* 



:*:£:*: 



HACK 
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An illustration of nested definitions and calls 



tOCATION 



NAME1 



NAME2 



NAME2 



NAME! 



OPERATION 



MACRO 



MACRO 



ENOM 



NAME2 



ENOM 



NAME1 



NAME2 



VARIABLE 



COMMENTS 

Ho 



AT THIS TIME* THIS LINE 
IS PART OF A DEFINITION 
RATHER THAN BEING A CALL. 



NAME1 IS CALLED AND EXPANOEO. 



CALL TO NAME2 IS VALID 



3. The following example illustrates two calls to a definition headed by a MACRO in format two 
using the location argument. The macro is named TABLE; its substitutable arguments are 
TABNAM, VALUE1, and VALUE2, where TABNAM is the loo* Hon argument. 



Location 



Code Generated 



«7<»1 17204000000000000000 
*7<»2 1721*000000000000000 



1*71*3 

<t7<»3 1720*000000000000000 

It7ki* 00000000000000000000 



LOCATION 



TABNAM 



SPVAL 
SPVAL 



OPERATION 



II 



MACRO 

VFO 

ENOM 



VFO 



VARIABLE 



COMMENTS 



ho 



TABLE*TABNAM»VALUE1»VALUE2 
60/VALUEl,60/VALUE2 

I 
I 



TABLE 1.0,2.0 

60/1.0*60/2.0 

I 



I 

CALL ONE 



VFD 



ENDH 



TABLE 1.0 
60/1.0,60/ 

ENOM 



! 

CALL TWO 



TABLE 
TABLE 



TABLE 
TABLE 
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4. An illustration of embedded parameters : 
Definition: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 




XAM 


MACRO 
LDM 
LJM 
ENOM 


1 — 

A,B 1 

5 ! 

i 



Call: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






XAM 


<SUM,10B), <SAM,IND3) 



Expansion: 



Location 



$&i 



Code Generated 



5010 72M» 
0117 7?*3 



LOCATION 



OPERATION 



LOM 
LJM 
ENOM 



VARIABLE 



COMMENTS 



130 



aw* 



N03 



5. The following example illustrates use of R= in macros: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


30 




ONSH 


MACRO 

R= 

SX2 

RJ 

ENOM 


N 

XI, N 
118 
=XCPM= 






OFFSW 


MACRO 

R= 

SX2 

RJ 

ENOM 


N 

XI, N 
12B 
=XCPM= 
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6. The following example illustrates a character in a symbol erroneously being interpreted as a 
delimiter for a parameter. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 




ABC 
7 

IOTA 


MACRO 

SET 

SA7 

• 
• 
• 

ENDM 

ABC 

SET 
?AT 

ENDM 


Z,VAL,f»5 I 

VAL ' 
Z. ALPHA J 

• 1 

* 

IOTA, 1,3 ' 
1 ' 
IOTA.At*f>HA ! ILLEGAL SYMBOL, TOO LONG 



The following example illustrates changing of control blocks and symbol qualifiers through 
substitutable parameters in a macro. (The same call could be used by using micros to 
change actual parameters. ) 





LOCATION 


OPERATION 


VARIABLE COMMENTS 




1 


11 


18 1 30 




_, , 

TAB 

TAGl 
TAG2 

TAGi 
TAG? 


MACRO 

USE 

QUAL 

BSS 

VFO 

USE 

QUAL 

ENDM 

TAB 

USE 

QUAL 

BSS 

VFO 

USE 

QUAL 

ENON 


BLOCK, KVAL | 
BLOCK 1 
KHAL 1 
10B | 
60 /-l 
* 

* 

ONE, ONE i 

ONE | TAB 
ONE i TAB 
10B ! TAB 
60/-1 TAB 

♦ | TAB 

• 1 TAB 
■ 1 TAB 




TAG! 
TAG* 


TAB 
USE 
QUAL 

BSS 

VFO 

USE 

QUAL 

FNOM 


TWO, TWO 1 "" '"*" 
TWO | TAB 
TWO I TAB 

1GB . TAB 

eo/-i ■ 1 ' TAB 

* TAB 

* , .. 'TAB 
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The following example illustrates a technique that an experienced programmer may wish to 
use to save time in processing of definitions. Remember that the assembler replaces the 
first substitutable parameter with 7701, the second with 7702, etc. Note that 7701 is ;A in 
display characters, 7702 is ;B, etc. This means that the programmer can use the display 
characters directly in place of his substitutable parameter names in the body of the definition 
and achieve the same results as if the assembler had made the substitution when it saved the 
definition. At the time the definition is assembled, the assembler replaces each 77xx with the 
actual parameter whether the code was inserted by the assembler when it saved the definition 
or by the programmer when he coded the definition. 



0i»0 



7771 o«ao«ooooa«i)3omo«3 



777? 

rrrz 

777 "< 
7773 

777U 
7T7% 

777 5 
7775 

777* 
7T76 



08W0008 00«B31111i%% 



000000!)V0000132«60<I5 



S*«*fl(!aVOOa«15M)%0%6 



0000001!0000012545W7 



OM0000001IM1761215G 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


II 


18 1 30 


CHAR 


MACRO 
CON 

ENOM 

• 
• 
• 

BASE 

CHAR 

CON 

ENDN 

CHAR 

CON 

FNDM 

CHAR 

CON 

FNDM 

CHAR 

CON 

ENOM 

TH6P 

CON 

ENOM 

CHAP 

TON 

ENOM 


ascii, internal, external, bcd 
;ojc;bta 



VS, 10,10,30 8 

301010*3 CHAR I 
'■■ CHAR 1 
Wf,H, 11,31 9 
311111*1* CHAR t 

CHAR 1 
45,60,20,13 + 
132060*5 CHAR 1 

CHAR t 
«t6,**0,«»0,15 - 
15%0%0%6 CHAR f 

CHAR 1 
47,5i»,5it,12 * 
125<»5Mi7 CHAR 1 

CHAR 1 
50,21,61,17 / 
17612151! CHAR 1 

CHAR 1 
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5.4.4 MACROE - EQUIVALENCED MACRO HEADER 

A MACROE pseudo instruction can be used instead of a MACRO instruction to notify the assembler to 
place the instructions forming the body of the macro in a table of macro definitions for assembly upon 
call, to place the macro name in the operation code table, and to save the list of parameter names so 
that actual parameters supplied in the macro call can be listed by name in any sequence in the macro 
call. 

The MACROE pseudo instruction has two forms: 

Format one: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


mname 


MACROE 


parameters 



Format two: 



LOCATION 



OPERATION 



MACROE 



VARIABLE SUBFIELDS 



mname, parameters 



The blank location field identifies the second format. 
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mname A legal name other than END, ENDD, IRP, LOCAL, or ENDM. It can be 

1-8 characters. A name that is identical to a PPU symbolic machine instruction 
name, pseudo instruction, or macro instruction already in the operation code 
table redefines the instruction. The most recent definition is the one that applies 
for the macro call. A redefinition causes an informative flag to be issued but the 
new definition holds. 

parameters Names of substitutable parameters. Unlike MACRO, the order in which names 

are listed does not determine the order in which parameters can occur in the 
macro call. Each name is 1-8 characters, the first of which must be alphabetic. 
A name cannot be END, ENDD, LOCAL, IRP, or ENDM. A name that begins 
with a number, or a second or later occurrence of a parameter name in the list 
is ignored. Any of the following special characters separate parameters in the 
list: 

+ -*/()$=, or . 

These characters have no meaning other than as separators. A blank terminates 
the list of parameters. The total number of unique parameter names and local 
symbols must not exceed 63 for any one macro definition. Also, any of these 
can be used to separate the mname from parameters in format two. 



Format one does not require parameters. 

Format two requires at least one substitutable parameter. This parameter is 
termed the location argument because the location field entry in the macro call 
is its substituted value. Omission of the location argument from a MACRO 
instruction in format two causes the assembler to issue a warning flag and 
ignore the definition. 

The assembler ignores a blank parameter produced by two concurrent separators 
or by a separator at the end of the list. 

For an example of definition and calls, refer to Equivalenced Macro Call. 



5.4.5 EQUIVALENCED MACRO CALL 

A macro definition headed by a MACROE pseudo instruction can be called by an instruction of the 
following format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


sym 


mname 


Pl=VP 2 =a 2 P n =a n 



mname Name of MACROE definition 
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sym Optional symbol. A symbol in the location field causes the location counter 

to be forced upper. The symbol is then assigned the value of the location 
counter. A location field;symbol on the first line in the definition that generates 
code is assigned the same address. If the location field of the macro call does 
not contain a symbol, the manner of the force upper is a function of the first- 
code-generating line in the macro expansion. 

p.=a. An equivalenced parameter. Each p is the name of a substitutable parameter. 

The &i is an actual parameter to be substituted for p^. The parameters need not 
be listed in the same order as they are listed on the MACROE instruction. 
Equivalenced parameters in the list are separated by commas and terminated 
by a blank. 

A null value is substituted for any parameter omitted from the list. 

When the first character of an actual parameter is a left parenthesis, the 
assembler considers all the characters between it and the matching parenthesis 
as an embedded parameter or as an iterative parameter. It is an iterative 
parameter when the substitutable parameter has been named in an IRP pseudo 
instruction (section 5.4.9, IRP). Otherwise, it is an embedded parameter. The 
assembler removes the outer pair of parentheses before substituting the enclosed 
character string in a line. Embedded parenthetical items must be properly 
paired. A parenthetical item can contain blanks and commas. 

After substitution, spacing between fields is the same as it was before substitution. One effect is that 
a null actual parameter replacing a formal parameter in a variable field effectively moves the comments 
field to the left. Then, when the line is assembled, the comments could be erroneously interpreted as 
a variable subfield. 

Processing of a location symbol and forcing upper of the first macro instruction depend on the MACROE 
form used for the definition. 

If the macro is defined using format one, that is, the macro name is in the location field, a location 
symbol on the macro call line forces the first word of generated code upper. The location field symbol 
is assigned the current value of the location counter. A location field (if any) on the line in the 
definition that generates the code is assigned the same address. If the location field of the macro call 
does not contain a symbol, the location and position counters are not affected by the call. 

When the macro is defined using format two, that is, the macro name is in the variable field and the 
first parameter is a location argument, the location symbol of the call is substituted for the first 
parameter or location argument. The fact that this argument came from the location field rather than 
the variable field has no special significance in the macro expansion. 

CAUTION 

After substitution, spacing between fields is the same 
as it was before substitution. 



5-26 60279900A 



Example: 
Location 



Code Generated 



5007 

5007 00000000000000000001 

5010 oooooooooooooooooooo 

5011 00000000000000000005 



5.4.6 OPDEF - DEFINE CPU OPERATION 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ho 












SAM 


MACROF 

CON 

CON 

CON 

FNOM 

• 
• 
• 

SAM 
TON 
CON 
CON 
FNOM 


A»B,C | 
A | 
B | 

C j 

A=i,C=5,R=0 

1 SAH 1 

SAM 1 

5 J SAM 1 

i SAM 1 



An OPDEF pseudo instruction notifies the assembler to place instructions in the body of the definition 
in a table of definitions for assembly upon call and place the instruction syntax in the operation code 
table. There is no way of removing the definition from the table. It can, however, be bypassed 
through redefinition, or disabled through CPSYN. If the syntax duplicates a CPU instruction already 
in the table, the OPDEF definition takes precedence. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 


syntax 


OPDEF 


parameters 



syntax 



The syntax consists of a mnemonic operator and variable field descriptors. 
The mnemonic operator consists of two letters. The first can be any letter. 
The second letter can be a register designator: A, B, or X in which case the 
operation field of the opdef call is recognized as cAn, cXn, or cBn (c is a 
unique character; n is 0-7); or the second letter can be any other letter, in 
which case the operation field of the opdef call is recognized simply by a 
two-letter mnemonic, such as EQ. 

The variable field descriptors define the order of appearance of all registers, 
expressions, and subfield separators that comprise the variable field of the 
opdef call. It consists of none, one, two, or three of the following 22 subfield 
descriptors. Q represents an expression. An r represents a register letter 
(A, B, or X). A comma separates two descriptors; a blank terminates the 
syntax. 
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void i Q 
r rQ 

-r -rQ 

r 1+ r 2 r 1+ r 2 Q 

-r 1+ r 2 -r 1+ r 2 Q 

r l* r 2 r l* r 2 Q 

"V r 2 " r l* r 2 Q 

r 1 /v 2 r^Q 

-v 1 /v 2 ~V r 2 Q 

r r r 2 r r r 2 Q 

- r r r 2 _r r r 2 Q 

For example, -rj*r 2 would be written as -X*B to describe -X3*B1 whereas rQ 
would be written as BQ to describe B2+ALPHA. 

The first descriptor immediately follows the mnemonic operator. 

parameters A substitutable parameter for each register designator (r) and expression 

designator (Q) in the syntax in the order in which they occur in the syntax 
(and, consequently, in the calling instruction). Parameters can be separated 
by any of the characters : 

+-*/()$=, or . 

A blank terminates the list. 

The assembler ignores a blank parameter produced by two concurrent separators 
or by a separator at the end of the list. A second or later occurrence of a 
parameter name in the list is ignored. 
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Examples : 



1. Listed below are some instructions that could be defined through OPDEF and the syntax entries 
that would describe them: 



Calling Instruction 


Opdef 
Syntax 




Operation 


Variable Subfields 


JPt 


Ktt 


JPQ 




JPt 


Bn+K 


JPBQ 




JP 


Bn+Bn+K 


JPB+BQ 




JP 


Bn.K 


JPB.Q 




JP 


Xn/Xn+K 


JPX/XQ 




NEt 


Bn, Bn, K 


NEB.B.Q 




LJ 


Bn-Bn,An-Xn,K 


LJB-B,A-X,Q 




BXnt 


-Xn*Xn 


BX-X*X 




SBnt 


Xn+Bn 


SBX+B 




LXn* 


Bn.Xn 


LXB.X 




JPt 


Bj+K 


JPBQ 




NEt 


Bj.Bk.K 


NEB.B.Q 




BXit 


-Xk*Xj 


BX-X*X 




SBit 


Xj+Bk 


SBX+B 




SBit 


Bj+Xk 


SBB+X 





t Legal COMPASS CPU instructions 
1t K represents an expression. 



60279900A 



5-29 



2. The following complete definition redefines single-address long jump JP as the EQ jump, which 
is faster than JP on the 6600 Computer System. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 




JPQ 


OPOEF 

EQ 

ENOM 


1 

Pi 1 
Pi 1 

1 



Each subsequent JP instruction that matches the syntax JPQ is assembled as an EQ. A JP 
instruction having a different syntax, such as the following, is not affected. 



Location Code Generated 

13002 0230007755 ♦ 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






JP 


03+ ALPHA | 



3. The following definition traps all floating point double-precision subtraction instructions 

(DXi Xj-Xk) and jumps to an error-check routine for debugging. I, J, and K are substitutable 
parameters used within the definition. 



LOCATION 



oxx-x 



OPERATION 



11 



OPOEF 



RJ 
ENOM 



VARIABLE 



COMMENTS 



30 



T.J.K 



CKOUT 



4. The following sequence causes KXi K to be defined as AXi K. It does not affect the standard 
RXi instructions involving registers. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 




RXQ 


OPOEF 
AX. Pi 
ENDH 


Pi,P2 ! 

P2 ' 

1 
I 



5.4.7 OPDEF CALL 

An opdef call resembles a CPU mnemonic machine instruction. The mnemonic code, quantity and 
sequence of registers, arithmetic operators, and expressions (excluding operators within the expressions) 
must match the syntax described in the OPDEF for the definition to be called. 
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NOTE 

If the Q in a descriptor is combined with register letters, 
a plus or minus must precede an expression in the call. 



OPDEF Syntax 


Call 




JPQ 


JP 


K 


JPBQ 


JP 


Bn+K 


JPB.Q 


JP 


Bn,K 


JPX/XQ 


JP 


Xn/X 



Not combined 
Combined 
Not combined 
Combined 

An OPDEF call can occur any place after the definition is saved. In substituting parameters, the 
assembler uses only the register values given in the call. It does not substitute the register designators. 

A location symbol on the opdef call line forces the first word of generated code upper. The location field 
symbol is assigned the current value of the current location counter after the force upper. A location 
field on the line in the definition that generates code is assigned the same value. If the location field of 
the opdef call does not contain a symbol, the manner of the force upper is a function of the first code- 
generating instruction in the expansion. If the call location field and the code-generating instruction 
field both contain symbols they are assigned the same value. 

Only a line having the correct syntax calls the definition. 

Examples: 

The following opdef defines an instruction having the syntax KX/X. On the call, the assembler 
substitutes 3, 4, and DIV (not X3, X4, and X. DIV) for PI, P2, and P3, respectively. 



Location Code Generated 



10161 27t0<» 



27606 



ZhhkH 



2<»64»6 



10162 HH3H6 



263<t3 



223*3 



LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 


11 


,8 


30 


IXX/X 


OPDEF 


P1,P2,P3 






PX.P2 


X.P2 






PX.P3 


X.P3 






NX.P2 


X.P2,B*t 






NX.P3 


X.P3,B<* 






FX.P1 


X.P2/X.P3 






UX.P1 


X.P1,B«» 






LX.Pi 


X.P1,B*» 






ENOM 








1X3 


XWX.DIV 






PX.<» 


X.k 


' 1X3 




PX.OIV 


X.DIV 


ZX3 




NX.ii 


X.fc,B>» 


1X3 




NX.OIV 


X.OIV,B<» 


1X3 




FX.3 


X.<»/X.0IV 


1X3 




UX.3 


X.3.BU 


1X3 




LX.3 


X.3,B<t 


1X3 




ENOH 




1X3 
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The following OPDEF selectively traps the SXi Xj+Bk instructions. 
Definition: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


I 




11 


18 1 30 




SXX+B 


OPDEF 

• 
« 

ENOH 


ItJ.K | 



Statements that call the definition: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 i 30 




SYH 


SX3 

• 
* 
• 

SX.NN 


X1+B2 | 
X6+B.XXX ! 



Statements that do not call the definition: 




LOCATION 


OPERATION 


VARIABLE COMMENTS 


i 




11 


18 1 30 






SX5 


X«f INO B DESIGNATOR OR +. 

1 






SX6 


B3+X* [REGISTERS INTERCHANGED 






SX.Y 


83 INO X DESIGNATOR OR OPERAND 






SY 


Xin-B<» {MNEMONIC CODE NOT SX. 



5.4.8 LOCAL— LOCAL SYMBOLS 

One or more LOCAL instructions that list symbols local to the definition optionally follows the MACRO, 
MACROE, or OPDEF pseudo instruction. The only lines that can separate the first header statement 
from LOCAL are comment lines. 



Format: 



symbols 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




LOCAL 


symbols 



List of local symbols. Each symbol must begin with an alphabetic character. 
Symbols must be separated by and must not include the following characters: 



/ ( ) 



or 
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A blank terminates the list. The m aximum number of local symbols and 
substitutable parameters is 63. COMPASS ignores the use of a substitutable 
parameter name in the local symbol list. 

A location field symbol, if present, is ignored. 

A symbol in the list is considered local to the macro; that is, it is known only within the macro 
definition. On each expansion of the macro, COMPASS creates a new symbol for each local symbol 
and substitutes it for each occurrence of the local symbol in the definition (other than in comment lines 
identified by * in column 1). Thus, invented symbols replace LOCAL- named symbols wherever they 
appear in a macro difinition in a manner similar to the way substitutable parameters are replaced. 

A user passes a local symbol to inner macro definitions or inner macro calls when he does not declare 
the symbol local in any of the inner definitions saved or called. That is, a symbol declared local in a 
macro can be referred to in any inner macro that does not also declare it as local (see example 2). 

A symbol not defined as local is accessible from outside the macro definition. An invented symbol is 
qualified if defined while in a QUAL block. It is not listed in the symbolic reference table. Blanks 
are preserved in a line containing a substituted symbol; COMPASS makes no attempt to change the 
structure of the line. 

On the listing, each invented symbol is shown as Hsym, where sym is unique for each local symbol in 
the subprogram. For example, if the symbol A is declared local to the macro, the subprogram can 
define a different symbol A elsewhere. 

Examples: 

1. In the following example, C is local to macro ABC and is passed to inner macro definitions. 
In the definition, each occurrence of formal parameter A is replaced by the parameter mark 
7701; each occurrence of B by the parameter mark 7702, and each occurrence of C by the 
parameter mark 7703. Then, when ABC is called, COMPASS assigns invented symbol 
tWOOOOl to C and replaces each occurrence of 7703 in definitions ABC and XYZ. 



LOCATION 



OPERATION VARIABLE 




COMMENTS 



II 



ABC 
C 

XYZ 



+«000001 
XYZ 



MACRO 
LOCAL 
BSS 



MACRO 
SA1 



ENOM 
ABC 



MACRO 
SA1 

ENOH 



DEFINITION 
OF XYZ 



DEFINITION 
OF ABC 



DEFINITION 
OF XYZ 



EXPANSION 
OF ABC 



ABC 
ABC 
ABC 
ABC 
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2. In the following example, C is local to each level. Note how this example differs from the 
preceding one. 



1017* 



LOCATION 



BCD 
C 

YZA 



OPERATION 



MACRO 
LOCAL 
8SS 



MACRO 
LOCAL 
SAl 



BSSZ 
ENOM 



VARIABLE 



COMMENTS 



|30 



A f B 

C 

10B 



DEFINITION 
OF BCO 



DEFINITION 
OF YZA 



On the call to BCD, the assembler replaces each occurrence of C with the invented symbol, 
t(000002 including the use of the symbol in the LOCAL instruction for macro XYZ. 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


11 


18 |30 


♦+000002 
YZA 

"000002 


BCD 

MACRO 
LOCAL 
SAl 

ENDM 


5.6 lEXPANSION OF BCO 

8SS 108 1 BCD 

! BCO 
♦♦000082 1 BC0 

++G00002 ' BCD 
BSSZ 1 , bco 

1 BCD 



Finally, on a call to YZA, t*000002 is defined as local and the assembler replaces each 
t*000002 with another invented symbol. Thus, each reference to C in the source code SAl 
instruction does not result in a reference to the BSS in the outer macro. 



10205 

10209 5110010206 + 

10206 



LOCATION 



♦♦000003 



OPERATION 



YZA 
SAl 



VARIABLE 



COMMENTS 



♦♦ 00 00 03 
BSSZ 1 



ENOM 
5.4.9 IRP - INDEFINITELY REPEATED PARAMETER 



EXPANSION OF YZA 



YZA 
YZA 
YZA 



An IRP pseudo instruction in a macro definition signals the beginning or end of a sequence of code to be 
assembled repeatedly with one parameter varied with each repetition. 

It has two formats : 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




IRP 
IRP 


parameter 



5-34 



60279900A 



The first form introduces the sequence and names the substitutable parameter; the second form 
terminates the repeated sequence. In either form, a location field symbol, if present, is ignored. 

The parameter name must be listed as a substitutable parameter on the MACRO or MACROE pseudo 
instruction for the definition. 

On the macro call, the~lndefinitely repeated parameter consists of one or more subparameters enclosed 
by parentheses and separated by commas. The assembler assembles the sequence for each subparameter; 
the number of copies of the sequence depends on the number of subparameters (none at all when the 
actual parameter is null). When the list of subparameters is exhausted, the assembler continues with 
the next line in the definition. If the named substitutable parameter does not occur between the two 
IRP instructions, the assembler repeats the code unchanged for each subparameter provided in the call. 
An IRP outside of the range of a macro has no effect on assembly other than to be included in statement 
counts. 

Examples: 



Repeat sequence within macro 



10207 

1020? 5110010127 ♦ 

7261010133 ♦ 

10210 5160010127 ♦ 

5110010131 + 

10211 7261010133 ♦ 

5160010131 ♦ 
10312 511O010132 ♦ 

7261010133 + 
10213 5160010132 ♦ 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


11 


8 |30 


ZAB 


MACRO 


ARG,B j -| 






IRP 


ARG i 






SA1 
SX6 
SA6 
IRP 


ARG "1 i 
Xl+B I REPEATED 
ARG J SEQUENCE 


. DEFINITION 
OF ZAB 




ENOM 

• 


1 






• 

ZAB 


(J,K,L) ,C0N 






IRP 


J*K,L | 






SA1 


J . 






SX6 


X1+C0N 1 






SA6 


J 1 






SA1 


K l 






SX6 


X1+C0N 1 






SA6 


* 1 






SA1 


** 






SX6 


X1+C0N 1 






SA6 


*. , 






IRP 


.1 






ENOM 


1 
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Assign symbol at every 100 g words of zeroed storage: 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


30 






USE 


STORAGE 






BUF 


MACRO 
IRP 


PI 
PI 






PI 


BSSZ 
IRP 
ENDM 
BUF 


100B 
(P,Q,R,S,T) 






SI %K; i«s:?.. 


IRP 


P,Q,R,S,T 






P 


BSSZ 


100B 






Q 


BSSZ 


100B 






R 


BSSZ 


100B 






S 


BSSZ 


100B 






T 


BSSZ 
IRP 
ENDM 


100B 





BUF 
BUF 
BUF 
BUF 
BUF 
BUF 
BUF 
BUF 



5.5 SYSTEM MACRO AND OPDEF DEFINITIONS 



Definitions of such general usefulness that they should be available to any program without each 
program defining them can be placed on the systems text file as system macros or can be placed on 
a file accessible through an XTEXT pseudo instruction. 

System macros provide for such system functions as reading and writing files and specifying parameters 
for file environment tables, etc. Systems macro definitions are available to COMPASS for each 
assembly. The programmer can use a macro call for a system macro at any time in his program. 
Descriptions of system macros are given in the operating system reference manual. 

Systems definitions can include any legal macro or opdef definition. An expansion of a call for a 
system definition is not normally included on the assembler listing. Use of the S option of the LIST 
pseudo instruction (section 4. 11. 1) enables listing of expansions of system definitions. 
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OPERATION CODE TABLE MANAGEMENT 



The COMPASS operation code table contains the information that COMPASS requires for interpreting 
legal operation field entries for COMPASS instructions. 

When assembly begins, the operation code table contains these entries. 

Pseudo instructions (except LOCAL) 
CPU symbolic instructions (Chapter 8 ) 
PPU symbolic instructions (Chapter 9) 
System macro and opdef definitions 

The MACRO, MACROE, and OPDEF pseudo instructions (Chapter 5) cause entries to be made in this 
table. In addition, the programmer has the capability of creating entries through the following 
instructions discussed later in this chapter: 

CPOP CPU operation 

PPOP PPU operation 

OPSYN Synonymous mnemonic operation 

CPSYN Synonymous CPU operation 

If a new entry redefines an instruction already in the table, the obsolete entry is not physically removed 
from the table. Instead, it is saved so that the table canbe reconstructed between assemblies. 
COMPASS reconstructs the operation code table using all the original system macros, opdefs, pseudo 
instructions, and symbolic machine instructions. No programmer-created entry is preserved from 
assembly to assembly. The number of entries in the table is limited to 4123. 

The only pseudo instruction that logically removes entries from the operation code table are PURGMAC 
and Pl'RGDEF. 

Entries in the operation code table are in two distinct formats permitting a logical division of the 
table. One type of entry permits identification of nn instruction by finding a match for the contents of 
the operation field, thus, it provides mnemonic recognition. The other type of entry is looked at only 
if the search for a mnemonic operator fails to yield a match during a CPU assembly. 

This type of entry provides for recognition of an instruction according to its syntax. COMPASS 
analyzes the statement to be interpreted, determines the syntax of the operati'on and variable subfields, 
and again searches the table. 
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Instructions recognized in the mnemonic search and the information provided to the assembler for 
each instruction are as follows: 



Pseudo instructions 



PPU symbolic instructions 



Instructions described through PPOP 



Macro instructions 



Instructions described through OPSYN 



The entry contains addresses to routines that perform 
pass one and pass two operations 

The entry describes the format of the instructions to 
be assembled 

The entry describes the format of the instruction to 
be assembled 

The entry directs the assembler to the location of the 
saved definition 

The entry is a copy of the synonymous entry 



For a PPU assembly, a failure to find an entry for a mnemonic operator causes an operation code error. 
For a CPU assembly, however, if the search for the mnemonic operator does not yield a match, 
COMPASS searches the operation code table again for an entry with a matching syntax. Instructions 
recognized in the syntactical search and the information provided to the assembler for each instruction 
are as follows: 



CPU symbolic instructions 
Instructions described through CPOP 
Instructions defined through OPDEF 
Instructions described through CPSYN 



The entry describes the format of the CPU instruction 
to be assembled 

The entry describes the format of the CPU instruction 
to be assembled 

The entry directs the assembler to the location of the 
definition 

The entry is a copy of the synonymous instruction 
The action taken depends on the synonymous entry 



If, following the second search of the operation code table, the statement still has not been identified, 
the assembler takes the following action: 

For a PPU assembly, it generates a 24-bit instruction of which the first 12 bits are zero. 
For a CPU assembly, it generates a 30-bit zero instruction. 

Although OPSYN and CPSYN pseudo instructions provide a means of rendering more than one 
instruction synonymous, only instructions of the same type can become synonymous. The logical 
division of the table between the two types of entries prevents mnemonically identified instructions from 
being made synonymous with syntactically identified instructions. 

When a MACRO, MACROE, PPOP, or OPSYN creates an entry for a mnemonic name that is already 
in the table for a different instruction, the new entry takes precedence over the old entry. Similarly, 
when a OPDEF, CPOP, or CPSYN redescribes a syntax already in the table for a different instruction, 
the new entry takes precedence over the old entry. As a result, the order of precedence for operation 
field recognition is, from highest to lowest: 

1. Programmer- created entries for mnemonically identified instructions 
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2. System macros, pseudo instructions, and PPU symbolic machine instructions 

3. Programmer- created entries for syntactically identified instructions 

4. CPU symbolic instructions 



Example: 



The following example illustrates a special case in which a macro name takes precedence over one 
form of a machine instruction, i. e. , the form using SB4 as an operation code. 



LOCATION 



SB«» 



SBh 



OPERATION 



MACRO 



ENON 



SB<» 



SB3 



OPSYN 



VARIABLE 



COMMENTS 



P1,P2 



PURGMAC 



Al+ABLE 



AH-ABLE 



NIL 



SBi» 



30 



DEFINE MACRO NAMED SB'* 



CALL TO MACRO. NOT CPU INSTRUCTION 



MACHINE INSTRUCTION 



DISABLES MACRO BUT DOES NOT 

RESTORE NORMAL USE OF SBk 

AS AN OPERATION CODE. EVEN IF 

IT MERE REOEFINED WITH OPDEF 

IT WOULD NOT BE RECOGNIZED. 

THE MACRO FORM ALWAYS TAKES 

PRECEDENCE. 

RESTORES NORMAL USE OF SQk 



6.1 MNEMONICALLY IDENTIFIED INSTRUCTIONS 

Mnemonically identified instructions include all pseudo instructions, macro instructions, and PPU 
symbolic instructions whether system or programmer defined. PPOP, OPSYN, NIL, and PURGMAC 
provide the programmer with a means of creating or removing operation code table entries that are in 
the mnemonically identified format. 



6.1.1 PPOP - PPU OPERATION CODE 

The PPOP pseudo instruction defines the operation and variable fields of a PPU symbolic machine 
instruction and creates an operation code table entry for the instruction. COMPASS generates an 
octal machine instruction of the defined format whenever the PPU instruction described by the PPOP 
instruction is used. If the operation code table already contains an entry for the name, the new 
definition takes precedence over the old during assembly of the subprogram or until it is redefined. 
No error is flagged. Any illegal parameter in PPOP causes COMPASS to ignore the PPOP and issue 
a 7-type error flag. 
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Format: 



LOCATION 


OPEHATION 


VAtlABLE SUBFIEIDS 


name 


PPOP 


ctl.val 



name 
ctl 



val 



Example: 



Mnemonic name, 1-8 characters 
Control of instruction assembly 



ctl 

1 
2 

3 
4 
5 

6 

7 



Significance 

Illegal; if used, COMPASS ignores the PPOP 

24-bit instruction with 12-bit address and no indexing 

12-bit instruction with signed relative address or absolute address 
(for example, UJN) 

24-bit instruction with 18-bit address (for example, LDC) 

12-bit instruction with 6-bit address (for example, LDN) 

24-bit instruction with 12-bit address and optional indexing 
(for example, LDM) 

12-bit instruction with signed relative address (for example, SHN) 

24-bit instruction with 12-bit address and required second 
(for example, LAM) 



An evaluatable expression specifying the 4- octal digit operation code value; 
usually, only the two leftmost digits are significant. If the assembly base is M, 
the field is assumed to be octal. 



Code Generated 



0i»0 



15 



7311 



51*15 OOMJ 





LOCATION 


0««ATION 


VAKIAtlf COMMENTS 


1 




11 


11 |30 




LA 

C 
STM 


PERISH 
RASE 

• 
* 
• 

FQU 
FQU 
PPOP 

* 
• 
• 

STM 


1 

! 

1 
1 

15 1 
<»0 | 
5,5400-H.A | 

I 

1 

1 

C i 
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6.1.2 OPSYN - SYNONYMOUS MNEMONIC OPERATION 

The OPSYN pseudo instruction makes a name in the location field of the OPSYN synonymous with the 
macro, pseudo instruction or PPU mnemonic name specified in the variable field. The size of the 
operation code table is the only limit to the number of instructions that can be made synonymous. 

Format: 



LOCATION 



name-i 



OPSYN 



VARIABLE SUBFIELDS 



nameo 



The name in the variable subfield must be previously defined as a standard instruction code. After an 
OPSYN, either name produces equivalent results. If the location field specifies a previously defined 
macro or operation code, the new definition takes precedence over the old without notification. Thus, 
a macro defined by a name that is subsequently used in an OPSYN location field is not called when 
the macro name is used in the operation field. The instruction actually called is the instruction 
named in the variable subfield of the OPSYN. On the other hand, the old macro definition is not lost 
and can be restored by purging the new definition with PURGMAC. 

Example : 



1. An operation named CALL is synonymous with RJM. 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


,6 


30 




CALL 


OPSYN 

• 


RJM 








CALL 


=XSUBR= 


PRODUCES SAME RESULTS 
AS IF IT WERE AN RJM 



2. In the following example, a programmer wishes to use a macro named LJM for part of the 
program and use the real LJM for the remainder of the program. 



LOCATION 



LJM. 



LJM 



LJM 



LJM 



OPERATION 



OPSYN 
PURGMAd 



MACRO 



ENDM 



OPSYN 



VARIABLE 



LJM 
LJM 



XX 



LJM. 



COMMENTS 



SAVE ORIGINAL DEFINITION <VS LJM. 
PURGE ORIGINAL DEFINITION 



CODE USING LJM MACRO 
RESTORES ORIGINAL LJM 
hCOOE USING ORIGINAL LJM 
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6.1.3 NIL -DO NOTHING PSEUDO INSTRUCTION | 

The NIL pseudo instruction resembles a no-op; it produces no code and conveys no information to the 
assembler. It is primarily designed for disabling a macro; it cannot be used with CPSYN. The 
following instructions could be used in place of NIL as nil instructions: 

ENDM 
ENDD 
ENDIF 
IRP 



Format: 



LOCATION 



OPERATION 



NIL 



VARIABLE SUBFIEIDS 



A location field symbol if present is ignored. 
Example: 



LOCATION 



MACK 



TAG 



OPERATION 



OPSYN 



MACK 



VARIABLE 



NIL 



A,B,6,73 



COMMENTS 

Tio 



The assembler interprets each call to MACK as a NIL instruction. TAG is not defined because it 
becomes the location field symbol for NIL when the statement is assembled. 

6.1.4 PURGMAC— PURGE MACROS 

The PURGMAC pseudo instruction provides a means of disabling operation code entries for the named 
instructions for the duration of the current assembly. 



Format: 



LOCATION 



OPERATION 



PURGMAC 



VARIABLE SUBFIELDS 



namej , name 2 , . . . , name 



name. 



Names of mnemonic operation codes for macro definitions, pseudo instructions, 
or PPU instructions. 



A location field symbol if present is ignored. 



6-6 



60279900A 



6.2 SYNTACTICALLY IDENTIFIED INSTRUCTIONS 

Syntactically identified instructions apply to CPU assemblies only. The CPOP and CPSYN pseudo 
instructions create operation code table entries for instructions that are to be identified through 
recognition of their syntax, rather than through the contents of the operation field only. 

6.2.1 CPOP - CPU OPERATION CODE 

The CPOP pseudo instruction describes the syntax of a new CPU symbolic machine instruction and 
creates an operation code table entry for the instruction. An instruction of the defined format is 
generated whenever the CPU instruction described by the CPOP instruction is used. If the operation 
code table already contains an entry for the instruction, the new definition takes precedence over the 
old during assembly of the subprogram. Any illegal parameter in CPOP causes COMPASS to ignore 
the CPOP and issue an error flag. 

Format: 



LOCATION 



sytx 



OPERATION 



CPOP 



VARIABLE SUBFIELDS 



ctl,val,reg 



sytx 



The syntax consists of a mnemonic operator and variable field descriptors. 
The mnemonic operator consists of two letters. The first can be any letter. 
The second letter can be a register designator: A, B, or X, in which case, 
the operation field of the instruction is recognized as cAn, cXn, or cBn, 
(c is a unique character; n is 0-7); or the second letter can be any other letter, 
in which case the operation field of the instruction is recognized simply by a 
two-letter mnemonic, such as EQ. 



The variable field descriptors define the order of appearance of all registers, 
expressions, and subfield separators that comprise the variable field of the 
instruction being described. It consists of none, one, two, or three of the 
following 22 subfield descriptors. Q represents an expression. An r represents 
a register letter (A, B, or X). A comma separates two descriptors; a blank 
terminates the syntax. 



void 

r 

-r 



r l +r 2 



Q 
rQ 
-rQ 
r 1+ r 2 Q 



" r l +r 2 



-r 1+ r 2 Q 



Y *Y 

1 2 



r l* r 2 Q 



-r *r 
1 2 



" r i* r 2 Q 



r l /r 2 



V r 2 Q 



60279900A 



6-7 



-V r 2 " r l /r 2 Q 

r r r 2 r r r 2 Q 

-r r r 2 -r r r 2 Q 

For example, to describe -X3*B1, the descriptor, -r, *r 2 , would be written as -X*B whereas, to 
describe B2+ALPHA, the descriptor rQ would be written as BQ. 



ctl Control of instruction assembly. 

ctl Significance 

15-bit instruction 

1 30-bit instruction 

2 15-bit instruction, force upper before assembly 

3 30-bit instruction, force upper before assembly 

4 15 bit instruction, force upper after assembly 

5 30-bit instruction, force upper after assembly 

6 15-bit instruction, force upper before and after 

assembly 

7 30-bit instruction, force upper before and after 

assembly 

val An evaluatable expression specifying a 9-bit operation code; if the base is M, 

val is assumed to be octal. 

reg Three octal digits specifying the order from left to right into which register 

numbers are to be inserted into the i, j, k portions of a 15-bit instruction, or 
into the i and j portions of a 30-bit instruction. If the assembly base is M, 
reg is assumed to be octal. 

1 Register number obtained from operation field 

2 Number of second register or only register in 

variable field 

3 Number of first of two registers in variable field 
Set field to 
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Example: 



Code Generated 



53731 



722 7231000003 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


II 


18 j 30 


SAX+B 
SXXQ 

TAG 


CPOP 
CPOP 

• 
• 
• 

SA7 
SX3 


0,5308,1328 'DEFINES SAI XJ+BK 
1,7208,1208 {DEFINES SXI XJ+K 

X3+B1 1 
Xl+3 J 



6.2.2 CPSYN - SYNONYMOUS CPU INSTRUCTION 

The CPSYN pseudo instruction renders an instruction with the syntax given in the location field 
synonymous with the instruction having the syntax specified in the variable field. The only limit to 
the number of CPU instructions that can be made synonymous is the size of the operation code table 
(4123 entries). 

Format: 



LOCATION 



sytx.. 



OPERATION 



CPSYN 



VARIABLE SUBFIELDS 



sytx, 



sytXj Syntax of a CPU instruction (see CPOP for legal forms). If this syntax is 

already in the operation code table, the table entry for sytx„ takes precedence 
over the old table entry for sytx. without notification. 

svtx 2 Syntax of a CPU instruction for which there must be an entry in the operation 

code table. Following the CPSYN, an instruction in either sytx 1 or sytx 2 
produces an octal instruction of the format described by the entry for sytx„. 

6.2.3 PURGDEF — PURGE CPU OPERATION CODE 

The PURGDEF pseud© instruction provides a means of disabling syntactically-identified operation code 
entries for the duration of the current assembly. 

Format: 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




PURGDEF 


sytx 



sytx Syntax of a CPU instruction (see CPOP for legal forms). 

A location field symbol, if present, is ignored. 
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MICROS 



The COMPASS micro capability enables the programmer to symbolically refer to a defined character 
string. When used in conjunction with IFC, DUP, STOPDUP, and SET pseudo instructions, micro 
strings provide for varied manipulation of character strings — testing for a particular character, 
counting characters, concatenation of strings, etc. Two instructions related to micros are discussed 
elsewhere. They are BASE (section 4. 4. 1) which allows optional micro definition of the base, and 
MICCNT (section 4. 6. 5) which allows a micro size to be defined as a symbol. 

Use of a micro definition requires two steps: definition of the character string, and substitution. In 
this discussion, substitution rather than definition is discussed first so that the reader has a better 
understanding of how a definition is used when it is described. 

7.1 MICRO SUBSTITUTION 

Wherever a micro name between micro marks (/) occurs in a statement other than a comment line 
(* in column 1), the assembler substitutes the micro before it interprets the statement. If column 72 
of the last card read is exceeded as a result of micro substitution, the assembler creates up to a 
maximum of 9 continuation cards, beyond which it discards excess characters without notification on 
the listing. No replacement takes place if the micro name is unknown or if one of the micro marks has 
been omitted. If the micro name is unknown, the assembler flags a non-fatal assembly error. 
If the micro name is null, that is, the two micro marks are adjacent, then 

1. Both micro marks are deleted, and 

2. No error flag is set 

Example: 

A micro identified as NAM is defined as the 7 characters: 

AODRESS 

A reference to NAM is in the variable field of a line: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




1! 


16 1 30 




LOC 


SAi 


^NAM^+4 



However, before the line is interpreted, COMPASS substitutes the definition for NAM producing the 
following line: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 [ 30 












LOC 


SAi 


ADDRESS*"* ! 



NOTE 
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Unless the A option of the LIST pseudo instruction is 
enabled, the listing depicts the instruction as it was 
before the substitution took place. 
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7.2 MICRO DEFINITION 

COMPASS provides four pseudo instructions that define micros, MICRO, OCTMIC, DECMIC, and 
BASE (section 4. 4.1). 



7.2.1 MICRO - DEFINE MICRO 

The MICRO pseudo instruction defines a character string and assigns a name to that string. 
Format: 



LOCATION 


OPERATION 


VANAIU SUtFIElOS 


micname 


MICRO 


iij , n 2 , dstringd 



micname 
n, 



dstringd 



Name by which definition is called; 1-8 characters 

Absolute evaluatable expression specifying starting character in string; when the base 
is M, COMPASS assumes that n is decimal. 

Absolute evaluatable expression specifying number of characters; when the base is M, 
COMPASS assumes that n 2 is decimal. 

Delimited character string. The delimiter d is a character not used in the 
string. 



Counting the first character after d as character 1, the assembler forms the string by extracting n 2 
characters starting with character il . If the second delimiting character occurs before count n 2 is 

I exhausted, the defined string terminates at that point. If n^ is greater than zero and n 2 is omitted, zero, 
or negative, the defined string includes all the characters from n^ to the closing delimiter (see second example) 

I If il is omitted, zero, or negative, the defined string is empty; no substitution takes place when the micro 
name is referred to. That is, n2 and the character string are ignored. 

A previously defined micro can be a part of a micro definition; one micro can be defined as a substring 
of another (see third example). 

A micro can combine previously defined micros or can be a subset of another. Also, a micro defined 
originally as one character string can be redefined subsequently with a different character string. After 
the redefinition, the original character string is inaccessible. 

Examples: 

1. The following MICRO defines NAME as the 19 characters beginning with A and ending with G. 



IOC • TlON 



OPEIATION 



VAWABLE 



COMMENTS 



130 



NftHE 



MICRO 



1,19,**LPHANUHFRIC STRING* 
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2. This example illustrates a blank character count. The defined string begins with A and is 
terminated by the closing delimiter. 



LOCATION 



MICKY 



OPERATION 



MICRO 



VARIABLE 



COMMENTS 



1,,*ALPHANUMERIC STRING* 



3. One micro can be defined as a substring of another. 



LOCATION 



NAM1 



NAM2 



OPERATION 



MICRO 



MICRO 



VARIABLE 



COMMENTS 



1, 25, »MAJOR [ALPHANUMERIC STRING* 

I 



7,,**NAM1** ISAME STRING AS IN EXAMPLES 1 AND 2 



4. One micro can combine others. 



LOCATION 



NAM1 
NAM2 
NAM3 



OPERATION 



MICRO 
MICRO 
MICRO 



VARIABLE 



COMMENTS 



130 



1,12,$ ALPHANUMERIC? 

1,7, X STRINGX 

1,,**NAM1**NAM2** COMBINES NAM1 AND NAM2 



5. A micro name can be redefined. 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


8 ho 




MSG 


MICRO 


1,6, 'STRING*, 




• 


• 


I ]C00E USING FIRST DEFINITION 




MSG 


MICRO 


J 1 
1,19,*ALPHANUMFRIC *MSG** 

. i 




• 


• 


t JCODE USING SECONO DEFINITION. 




• 


• 


J 'FIRST DEFINITION IS INACCESSIBL 



6. Micro substitution takes place before a line is assembled or examined for syntax; 
thus, the following is possible. 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


II 


18 


30 


NAM 

?<NAMf<4 
LOC 


MICRO 

• 
• 
• 

SAl 


1,,* LOC 
ADDRESS+4 


SA! ADDRESS+* 
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7.2.2 DECMIC - DECIMAL MICRO 

Using a decimal conversion, the DEOMIC pseudo instruction converts the expression into a character 
string to be saved under the name specified. 

Format: 



LOCATION 



micname 



OPERATION 



DECMIC 



VARIABLE SUBFIELDS 



aexp,n 



micname 

aexp 
n 



Name by which definition is called; 1-8 characters 
Absolute expression to be converted 

Optional absolute expression specifying number of characters in the defined 
string. The defined string is a maximum of 10 characters regardless of the 
magnitude of n. When base is M, COMPASS assumes that n is decimal. 

If n is omitted or has a zero value, the micro contains the number of characters 
indicated by the conversion to a maximum of 10 characters. If the converted 
expression has more than n (or 10) digits, the most significant digits are 
truncated. If the value has fewer than n digits, the string is right justified and 
filled with leading zeros. All numbers are treated as positive. 



Example: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 f 30 




V 

SYMBL 


DECMIC 
MICRO 


B,6 | 

1,,»*V* STORAGE NEEDED* 


SVMBL 


[MICRO 


l,,»aOIQ2«i STORAGE NEEDED* 



7.2.3 OCTMIC - OCTAL MICRO 

Using an octal conversion, the OCTMIC pseudo instruction converts the value of the expression into a 
character string to be saved under the name specified. 
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Format: 



LOCATION 



micname 



OPERATION 



OCTMIC 



VARIABLE SUBFIELDS 



aexp.n 



micname 

aexp 

n 



Name by which definition is called; 1-8 characters 

Absolute expression to be converted 

Optional absolute expression specifying number of characters in the string. 
The defined string is a maximum of 10 characters regardless of the magnitude 
of n. When base is M, COMPASS assumes n as a decimal. If n is omitted or 
has a zero value, the micro contains the number of characters indicated by the 
conversion to a maximum of 10 characters. 

If the converted expression has more than n (or 10) digits, the most significant digits are truncated. 
If the value has fewer than n digits, the string is right justified and filled with leading zeros. All 
numbers are treated as positive. 

Example: 



LOCATION 



VI 



SI 

fet-. 



OPERATION 



OCTMIC 



MICRO 



VARIABLE 



COMMENTS 



|30 



B,6 



l,,**Vi* AODITIONAL STORAGE NEEDED* 
t«*«SB£M» ADDITIONAL STORAGE NEEDC0*. 



7.3 PREDEFINED MICRO NAMES 

Two standard micros (DATE and TIME) are predefined by the COMPASS assembler. They are available 
for every assembly. The programmer simply writes the micro reference as desired. 

7.3.1 DATE 

The DATE micro contains the current date in 10 characters in the following form as obtained from the 
operating system: 

A yr/mo/dy. 
The micro reference is ^DATE^. 
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7.3.2 TIME 

The TIME micro contains the current time of day in 10 characters in the following form as obtained 
from the operating system: 

Ahr.min. sec. 

The micro reference is ^TIME/. 

Example: 



LOCATION 



OPERATION 



TITLE 



VARIABLE 



COMMENTS 



| 30 



PROGRAM ASSEMBLED ON *0ATE* AT*TIME* 
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CPU SYMBOLIC MACHINE INSTRUCTIONS 



8 



6000/7000 COMPASS recognizes symbolic notation for all 7600 Central Processor Unit instructions and 
all 6000-Series Computer Systems Central Processor Unit instructions. 

The assembler identifies each symbolic instruction according to its syntax and generates a one parcel 
15-bit instruction or a two parcel 30-bit instruction. The object code for an instruction is generated 
in the block in use when the instruction is encountered. 



8.1 MACHINE INSTRUCTION FORMATS 

Figures 8-1 and 8-2 illustrate the formats for CPU 15-bit and 30-bit instructions generated by the 
assembler. 



gh 



J 



14 08 05 02 00 

Figure 8-1. CPU 15-Bit Instruction Format 



gh 


i 


J 


! K 



29 23 20 17 14 00 

Figure 8-2. CPU 30-Bit Instruction Format 

gh 6-bit instruction code 

ghi 9-bit instruction code 

i 3-bit code specifying one of eight designated registers (e.g. ,Ai) 

j 3-bit code specifying one of eight designated registers (e. g. , Bj) 

k 3-bit code specifying one of eight designated registers (e. g. , Bk) 

K 18-bit integer value used as an operand, address of an operand, or branch destination 

address. 

jk 6-bit integer value specifying a shift count or mask count 

Figure 8-3 illustrates possible arrangements of one and two parcel instructions in a 60-bit CPU 
instruction word. Generally, the assembler does not allow a two-parcel instruction to begin in the 
fourth parcel of a word. However, the assembler may generate a 30-bit instruction in a fourth 
parcel when all of the following are true: 

1. The assember is at the fourth parcel (position counter is 15) 
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2. The instruction does not include K. Note that if K is included in the syntax and reduces to zero, 
it requires 30 bits because the evaluation of K takes place in the second pass whereas the space 
for the instruction is reserved in the first pass. 

3. The instruction does not have a location field symbol or is not otherwise forced upper. 

When a two parcel instruction begins in the last parcel of a word, the 7600 executes it as if there 
were a fifth parcel in the instruction word and that parcel contained all zeros. On the 6400, this 
condition causes an error exit. On the 6600, the CPU takes the first parcel of the current instruc- 
tion. 

Before it assembles an instruction that must begin in the first parcel (forced upper) and after it 
assembles an instruction that requires the instruction following it to be forced upper, the assembler 
completes a word as follows: 

Lower 15 bits remain They are packed with a one parcel NO (pass) instruction 

Lower 30 bits remain They are packed with a two parcel SB0 B0+46000B instruction 

Lower 45 bits remain They are packed with a NO instruction and an SB0 B0+46O00B instruction 



First 
Parcel 



Second 
Parcel 



Third 
Parcel 



Fourth 
Parcel 



15 


15 


15 


15 




59 




44 




29 




14 




00 


30 


15 


15 




59 








29 




14 




00 


15 


30 


15 




59 




14 








14 










15 


15 


30 




59 




44 




29 








00 


30 


30 





59 



29 



00 



Figure 8-3. Arrangements of Instructions in a 60-bit CPU Word 
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8.2 INSTRUCTION EXECUTION 

Execution times for all instructions are listed in Appendix A. 

8.2.1 6600/6700 EXECUTION 

After an exchange jump start by a PPU and CPU program, CPU instructions issue automatically in the 
original sequence, to an 8-word instruction stack. The stack can hold a program loop consisting of up to 
26 15-bit instructions and one 30-bit instruction. 

Instructions are read from the stack one at a time and issued to the functional units (table 8-1) for 
execution. A scoreboard reservation system in CPU control keeps a current log of which units and 
operating registers are reserved for computation results from functional units. 

Each functional unit executes several instructions, but only one at a time. Some branch instructions 
require two units, the second unit receives direction from the branch unit. 

The rate of issuing instructions varies from the maximum of one instruction every 100 nanoseconds 
(one minor cycle). Sustained issuing at this rate may not be possible because of functional unit and CM 
conflict or because of serial rather than simultaneous operation of units. Program run time can be 
decreased by efficient use of the units. Instructions that are not dependent on previous steps may be 
arranged or nested in program areas where they may be executed concurrently with other operations to 
eliminate dead spots in the program and increase the instruction issue rate. 

The following steps summarize instruction issuing and execution: 

• An instruction is issued to a function unit when: 

Specified functional unit is not reserved 

Specified result register is not reserved for a previous result 

• Instructions are issued to functional units at minor cycle intervals when no reservation conflicts 
are present. 

• Instruction execution starts in a functional unit when both operands are available. Execution is 
delayed when an operand is a result of a previous step which is not complete. 

• No delay occurs between the end of a first unit and the start of a second unit which is waiting for 
the results of the first. 

• After a branch instruction no further instructions are issued until instruction has been executed. 
In the execution of a branch instruction, the branch unit uses: 

Increment unit to form the instructions that branch to K + Bi and branch to K if Bi . . . 

Long add unit to perform the instructions that branch to K if Xj ... 

Time spent in the long add or increment units is part of total branch time. 

Read central memory access time is computed from the end of increment unit time to the time an 
operand is available in X operand register. Minimum time is 500 nanoseconds assuming no central 
memory bank conflict. 



t The 6700 also includes a 6400-type central processor unit 
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TABLE 8-1. 6600/6700 FUNCTIONAL UNITS 



UNIT 



Branch 
Boolean 

Shift 

Floating Add 

Long Add 
Floating Multiply 

Floating Divide 

Increment 



GENERAL FUNCTION 



Handles all jumps or branches from the program. 

Handles the basic logical operations of transfer, logical product, 
logical sum, and logical difference. 

Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and normalize, pack, and 
unpack floating point operations. The unit also includes a mask 
generator. 

Performs single or double precision floating point addition and 
subtraction on floating point operands. 

Performs addition and subtraction of two 60-bit fixed point operands 

Performs single or double precision floating point multiplication on 
floating point operands 

Performs single precision floating point division of floating point 
operands; also counts the number of 1 bits in a 60-bit word. 

Performs one's complement addition and subtraction of 18-bit operands 
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8.2.2 6400/6500 EXECUTION 

The 6400 aad 6500 systems CPU has a unified arithmetic unit, rather than separate functional units as 
in the 6600 system. Instructions in the 6400 and 6500 CPU are executed sequentially. 

For efficient coding in the 6400 and the 6500 central processor unit: 

Always attempt to place jump instructions in the upper portion of the instruction word to avoid both 
the additional time for RNI (2 minor cycles) and the possibility of a memory bank conflict with 
(P + 1). 

Where possible, place load/store instructions in the lower two portions to avoid lengthening 
execution times. 

Reading the next instruction words of a program from central memory, RNI, is partially concurrent 
with instruction execution. RNI is initiated between execution of the first and second instructions of the 
word being processed. Initiating RNI operation requires two minor cycles; the remainder of the RNI 
is parallel in time with execution of the remaining instructions in the word: 



Initiate 
RNI 




200 

NSEC 



-^N 



— ^ 



Execution of 

"instructions - 

2 and 3 



RNI 
-minimum of . 
800 NSEC 



• Total RNI time 



-xh 



-sN 



In calculating execution times, two minor cycles are added to each- instruction word in a program to 
cover the RNI initiation time. Exceptions are the return jump and the jump instructions (in which the 
jump condition is met) when they occupy the upper position of the instruction word. Since the times for 
these instructions already include the time required to read the new instruction word at the jump 
address, no additional time is consumed (AppendixA). 
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Example : 





P 
K 


Jump 


to K (met) 


Pass 


Pass 


















Addl 


Add 2 


Load 


Load 




Instruction 






Minor Cycles Required 


Jump 










13 


Addl 










5 


RNI Initiation 










2 


Add 2 










5 


Load 










12 


Store 










10 


Total Time 












47 Minor Cycles 



After RNI is initiated (between the first and second instructions of the word), a minimum of eight 
minor cycles elapses before the next instruction word is available for execution. Even if the lower 
order positions of the word should require less than eight minor cycles, a minimum of eight minor 
cycles is allowed regardless of the execution times stated in Appendix A. 

Example : 



Jump to K 
(not met) 


Pass 


Pass 



P + 1 



8.2.3 7600 EXECUTION 

Execution of an arithmetic or logical machine instruction takes place in one of nine functional units in 
the computation section of the 7600 CPU. Each is a specialized unit with algorithms for a portion of 
the CPU instruction execution. Table 8-2 lists the general function of each unit. A number of functional 
units may be in operation at the same time. 
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TABLE 8-2. 7600 FUNCTIONAL UNITS 



UNIT 



Boolean 

Shift 

Normalize 
Floating Add 

Long Add 

Floating Multiply 

Floating Divide 

Population Count 
Increment 



GENERAL FUNCTION 



Handles the basic logical operations of transfer, logical product, logical 
sum, and logical difference. It also performs the pack and unpack 
floating point operations. 

Executes operations basic to shifting. This includes left (circular) 
and right (end-off sign extension) shifting, and mask generation. 

Performs the normalize operations. 

Performs single or double precision floating point addition or subtraction 
on floating point operands. 

Performs integer addition or subtraction of two 60-bit fixed point 
operands. 

Performs single or double precision floating point multiplication on 
floating point operands. 

Performs single precision floating point division of floating point 
operands. 

Counts the number of 1 bits in a 60-bit word. 

Performs one's complement addition and subtraction of 18-bit operands. 



A functional unit receives one or two operands from operating registers at the beginning of instruction 
execution and delivers the result to the operating registers after performing the function. The functional 
units do not retain any information for reference in subsequent instructions. The units operate in three- 
address mode with source and destination addressing limited to the operating registers. 

Except for the floating multiply and divide units, all 7600 functional units have one clock period 
segmentation. This means that the information arriving at the unit, or moving within the unit, is 
captured and held in a new set of registers at the end of every clock period. It is therefore possible 
to start a new set of operands for unrelated computation into a functional unit each clock period even 
though the unit may require more than one clock period to complete the calculation. This process may 
be compared to a delay line in which data moves through the unit in segments to arrive at the destination 
in the proper order but at a later time. All functional units perform their algorithms in a fixed amount 
of time. No delays are possible once the operands have been delivered to the front of the unit. 

The 7600 floating multiply unit has a two clock period segmentation. Operands may enter the multiply 
unit in any clock period providing there was no multiply operation initiated in the preceding clock period. 

The floating divide unit is the only 7600 functional unit in which an iterative algorithm is executed. There 
is little segmentation possible in this unit. However, to increase execution speed, the beginning of a new 
divide operation can follow a previous divide operation by 18 clock periods for a gain of 2 clock periods. 

Instructions involving storage references for operands or program branching are difficult to time. 
Program branching within the instruction stack causes no storage references and small program loops 
can therefore be precisely timed. 
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8.3 OPERATING REGISTERS 

Twenty-four registers minimize memory references for arithmetic operands and results: 



Function 


Identity 


Length 


Number 


Operand Registers 
Address Registers 
Index Registers 


XO - X7 
AO - A7 
BO - B7 


60 Bits 
18 Bits 
18 Bits 


8 
8 
8 



A register is reserved if it is the destination of an instruction that has been initiated but has not been 
completed. A register is free in the clock period (or minor cycle) following the store into it. 

8.3.1 X REGISTERS 

Eight 60-bit X registers in the computation section of the CPU designated XO, XI, . . . ,X7 are the 
principal data handling registers for computation. Data flows from these registers to the SCM (CM) 
and the LCM (7600 only). Data also flows from SCM (CM) and LCM (7600 only) into these registers. 
All 60-bit operands involved in computation must originate and terminate in these registers. 

Operands and results transfer between SCM (CM) and these registers as a result of placing SCM (CM) 
into corresponding address registers. 

On the 7600, the X registers also serve as address registers for referencing single words from LCM. 
X0 is used as the LCM relative starting address in a block copy operation. 

8.3.2 A REGISTERS 

Eight 18-bit A registers in the computation section of the CPU, designated as A0, Al, . . . , A7, are 
essentially SCM (CM) operand address registers. With the exception of A0 and X0, A registers are 
associated one-for-one with the X registers. Placing a quantity into an address register Al - A5 
causes an immediate SCM (CM) read reference to that relative address and sends the SCM (CM) word 
to the corresponding operand register XI - X5. Similarly, placing a value into address register A6 
or A7 causes the word in the corresponding X6 or X7 operand register to be written into that relative 
address of SCM (CM). 

The A0 and X0 registers operate independently of each other and have no connection with SCM (CM). 
A0 is used as the relative SCM (CM) starting address in a block copy operation and for scratch pad or 
intermediate results. 



8.3.3 B REGISTERS 

Eight 18-bit B registers in the computation section of the CPU designated as B0, Bl, . . . , B7 are 
primarily indexing registers for controlling program execution. Program loop counts can be incremented 
and decremented in these registers. 
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Program addresses may be modified on the way to an A register by adding or subtracting B register 
quantities. The B register also holds shift counts for pack and normalize operations and the channel 
number for channel status requests. 

BO always contains positive zero; that is, BO is held clear. Often, as a programming convention, Bl 
or B7 contains positive 1. See the Bl=l, the B7=l, and the R= pseudo instructions. 

8.4 SYMBOLIC NOTATION 

This section describes notation used for coding symbolic CPU machine instructions. Instructions are 
listed according to octal sequence. Instructions unique to a computer system are identified as such 
These instructions can be assembled on any machine but will execute properly on the noted machine only 
For details and special conditions arising during instruction execution, refer to the relevant hardware 
system reference manual. 

The location field of a symbolic machine instruction optionally contains a location symbol. When the 
symbol is present, it is assigned the value of the location counter after the force upper (if any) occurs. 

The operation field of a symbolic CPU machine instruction contains a mnemonic operator, the last two 
characters of which are often a register designator. 

The variable field contains one, two, or three subfields. For 15-bit instruction, subfields take the 
forms : 



r 

-r 
r,r 
r op r 
-r op r 



r is a register designator 

op is a register operator + - * / 



±J k Jk is an absolute expression specifying a shift count or mask bit count. 

If the expression value is in the range -60 to -0, inclusive, COMPASS 
adds 60 to it. If it is less than -60 or greater than 63, COMPASS sets 
a warning flag and uses only the low-order 6 bits of the expression value. 



For a 30-bit instruction, subfields take the forms 
K 



The single subfield contains an absolute, relocatable, or external expression 
that does not include a register. 

r °P K The single subfield contains an absolute, relocatable, or external expression 

that includes a register designator; op is an expression operator: 



* 



/ 



r ' K One subfield contains a register designator, the other subfield contains an 

absolute, relocatable, or external expression that does not include a register 
designator. 

r » r » K Two subfields contain register designators; a third contains an absolute, 

relocatable, or external expression that does not include a register. 
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In the formats and examples, K reduces to an 18-bit value that represents one of the following in pass 
two: 

An absolute address or a word count 

An external symbol + an integer value 

An address that is relocatable relative to the program origin or common block origin 

An address of a literal 

If K is negative, the assembler inserts the one's complement of the integer value in the K portion of the 
instruction. 



In the descriptions of the formats, +K designates that the evaluation of all nonregister elements can 
result in a positive or negative value for the expression (see section 2. 8. 2 Evaluation of Expressions). 
Use of +K to represent the integer portion of the expression does not imply that the first term oper- 
ator in the expression is an expression operator. If you consider that a and b are terms in expression 
K, then +K indicates that the sum of the values of a and b is positive and -K indicates that the sum of 
the values is negative. Thus, -K does not mean that a-b would become -a+b. 

In the following example, the symbol XRAY has the value 407 . The first term operator (-) forms the 



value 777370 



8* 



Subtracting 1 from this results in 777367 or a -K (-410 ). 

8 8 



Code Generated 
13 7212777367 





LOCATION 


OPEIATION 


VAKIAILE 


COMMENTS 


1 

— 




II 


ia 


ho 






SX1 


X2-XRAY-1 


— t 

1 

1 



Unless otherwise noted, subfields can be in any order. COMPASS also allows an added degree of 
flexibility by allowing the variable subfields of an instruction to be written in the operation field with 
each subfield preceded by a comma. For example: 



Code Generated 

can be written 

Code Generated 

26123 



LOCATION 



LOCATION 



OPERATION 



UX1 



VAIIABLE 



B2,X3 



OPERATION 



UX1,*2 



VAKIAIIE 



X3 



The instructions are identical to the assembler. 



COMMENTS 



130 



COMMENTS 



130 
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Similarly, the following instructions are regarded as identical. Use of this feature is optional. 



Code Generated 



0'*2300<»507 
0«»2300'*507 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






EQ B2tt*3.K | 
EQ t B2 B3,K 1 
EQ,B2,B3 K 1 
EQ,B2,E|3,K j 



8.4.1 PROGRAM STOP INSTRUCTION t6000-SERIES ONLY) 

This instruction stops the central processor unit at the current step in the program. An exchange jump 
is necessary to restart the central processor unit. The contents of the location field become a sub- 
subtitle on the assembler listing. The assembler forces upper before and after assembling a PS 
instruction. 



Formats: 














6600 Functio 


nal Unit: Branch 


Operation 


Variable 


Description 


Size 


Octal Code 


PS 
PS 


K 


Program stop 
Program stop 


30 bits 
30 bits 


00000 00000 
0000K 


Example : 










Code Generated 






LOCATION 


OPERATION 


VARIABLE COMMENTS 




i 




11 


18 1 30 


ooooooooon 






PS 




— 1 

i 





1S027SSOOC 
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8.4.2 ERROR EXIT INSTRUCTION (7600 ONLY) 

This instruction is exclusive to the 7600. Its execution is treated as an error condition and the machine 
sets the program range condition flag in the PSD register. The condition flag then generates an error 
exit request which causes an exchange jump to address (EEA). All instructions issued prior to this 
instruction are run to completion. Any instruction following this instruction in the current instruction 
word is not executed. When all operands have arrived at the operating registers as a result of previously 
issued instructions, an exchange jump occurs to the exchange package designated by (EEA). 

The i, j, and k designators, which are ignored by the computation section, are set to zero by the 
assembler. The program address stored in the exchange package on the terminating exchange jump is 
advanced one count from the address of the current instruction word (P=P+1). This is true regardless 
of which parcel of the current instruction word contains the error exit instruction. 

The error exit instruction is not intended for use in user program code. The program range condition 
flag is set in the PSD register to indicate that the program has jumped to an area of the SCM field which 
may be in range but is not valid program code. This should occur when an incorrectly coded program 
jumps into an unused area of the SCM field or into a data field. The program range condition flag is 
also set on the condition of a jump to address zero. These conditions can be determined on the basis 
of the register contents in the exchange package. The existence of an error exit condition resulting 
from execution of this instruction can thus be deduced. 

The location field of an ES instruction becomes a sub-subtitle on the assembler listing. 

Format: Functional Unit: None 



Operation 



ES 
ES 



Variable 



K 



Description 



Error exit to EEA 
Error exit to EEA 



Size 



15 bits 
15 bits 



Octal Code 



00000 
00000 



Example: 



Code Generated 



00000 



LOCATION 



OPERATION 



ES 



VARIABLE 



COMMENTS 



8-12 



§02!9SOOA 



8.4.3 RETURN JUMP INSTRUCTION 

When this instruction is executed, an unconditional jump to the current address plus one [(P)+l)] is 
stored in the upper half of relative address K in SCM and control then transfers to K+l for the next 
instruction. The lower half of the stored word is all zeros. The instruction always branches out of 
the instruction stack and voids all instructions currently in the instruction stack. 



After the instruction is executed the octal word at K is: 

II 



Address K 



4 



P + 1 



0000000000 



3 



59 ^ 
Bi=Bj 



29 



00 



This instruction is intended for transferring control to a subroutine between execution of the current 
instruction word and the following instruction word. Instructions appearing after the return jump 
instruction in the current instruction are not executed. The called subroutine must exit at address K 
in CM (SCM). A jump to address K of the branch routine returns the program to the original sequence. 
The assembler sets the unused j designator to zero. 



A force upper occurs after the instruction is assembled. 



Format: 



6600 Functional Unit: Branch 
7600 Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


RJ 


K 


Return jump to K 


30 bits 


0100K 



Example: 

Code Generated 
0100005250 «■ 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


ie ho 














RJ 


HELP i 
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8.4.4 ECS INSTRUCTIONS (6000-SERIES ONLY) 

These instructions initiate either a read or write operation to transfer (Bj) + K 60-bit words between 
extended core storage (ECS) and central memory (CM). The initial ECS address is (XO) + RA ECS ; 
the initial CM address is (AO) + RA„ M , 

The assembler forces upper before assembling an RE or WE instruction. 

Three error conditions cause an error exit to the lower-order 30 bits of the instruction word containing 
the RE or WE instructions. These 30 bits should always hold a jump to an error routine. The conditions 
are: 



1. Parity error(s) when reading ECS. If a parity error is detected, the entire block of data is 
transferred before the exit is taken. 

2. The ECS bank from/to which data is to be transferred is not available because the bank is in 
maintenance mode, or the bank has lost power. If either of these conditions exists on an 
attempted read or write, an immediate error exit is taken. 

3. An attempt to reference a nonexistent address. On an attempted write operation, no data 
transfer occurs and an immediate error exit is taken. If the attempted operation is a read, 
and addresses are in range, zeros are transferred to central memory. This is a convenient 
high-speed method of clearing blocks of central memory. 

For additional information about these instructions, refer to the CONTROL DATA® 6400/6500/6600 
Computer Systems Extended Core Storage Reference Manual, Publication No. 60225100. 



Formats: 




Functional Unit: None 



Description 


Size 


Octal Code 


Read extended core storage 


30 bits 


OlljO 00000 


Read extended core storage 


30 bits 


011 OK 


Read extended core storage 


30 bits 


OlljK 


Write extended core storage 


30 bits 


012J0 00000 


Write extended core storage 


30 bits 


0120K 


Write extended core storage 


30 bits 


012JK 



Examples: 

Code Generated 

on ooo?coo 
on^ooioco 

012*001000 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ho 






PE 


2000B | 

1 
"74-1000B | 

1300B+B5 j 
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8.4.5 LCM BLOCK COPY INSTRUCTIONS (7600 ONLY) 

Block copy instructions move quantities of data between LCM and SCM as quickly as possible. All 
activity in the CPU other than I/O word requests is stopped during a block copy operation. All 
instructions issued prior to a block copy instruction are executed to completion and no further 
instructions issue until the block copy is nearly completed. As a result of these restrictions the 
data flow between LCM and SCM can proceed at the rate of one 60-bit word each clock period. 
When an I/O multiplexer word request for SCM occurs during this transfer, the data flow is 
interrupted for one clock period. The I/O word address is inserted in the stream of addresses to 
the SAS, and the addresses for the block copy are resumed with a minimum of a one clock period delay. 
An additional delay will occur if the I/O reference causes a bank conflict in SCM. 



60279900D 8-14.1 



The length of the block is determined by adding the quantity K to the contents of register Bj. Either 
quantity may be used as an increment or decrement. The result is an 18-bit integer which is truncated 
to a 10-bit quantity. Thus, a maximum block size is 1777 g . (For example, if the result of the add is 
003000 g , the instruction transfers 1000 g words. ) No error indications are given when this occurs unless 
the field length is exceeded causing a block range error. If the block length is zero, the instruction 
becomes a do-nothing instruction; the condition is not error flagged. 

Relative source or destination addresses begin at (AO) in the SCM and at the relative LCM address 
determined from the lowest order 19 bits of (XO). If (XO) is negative, the 19 bits are treated as a 
positive integer. If the sum of ( X0 18 _ 00 ) and the block count exceeds the (FLL), the copy is not 
executed and the LCM block range condition flag is set in the PSD register. Similarly, if the sum of 
(AO) and the block exceeds (FLS), the copy is not executed and the SCM block range condition flag is 
set in the PSD register. 

Any error condition occurring during execution of a block copy instruction causes a flag to be set in the 
PSD register but does not interrupt the block copy instruction. No further instructions are issued during 
block transfer of data. Instructions already issued are completed; all other activity, with the exception 
of I/O word requests, stops. 



Formats : 



Functional Unit: None 



Operation 



RL 
RL 
RL 

WL 
WL 
WL 



Variable 



Bj 
K 
Bj+K 

K 
Bj 
Bj+K 



Example : 

Code Generated 

0115001000 
0110002000 
012<f777f77 



Description 



Block copy (Bj) words from LCM to SCM 

Block copy (K) words from LCM to SCM 

Block copy (Bj) + K words from LCM to 
SCM 

Block copy (K) words from SCM to LCM 

Block copy (Bj) words from SCM to LCM 

Block copy (Bj) + K words from SCM to 
LCM 



Size 



30 bits 



Octal Code 



30 bits 


OlljO 00000 


30 bits 


011 OK 


30 bits 


OHjK 


30 bits 


01 2 OK 


30 bits 


012J0 00000 



012JK 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


,8 


30 






RL 


10 0B+B5 








RL 


2000B 








WL 


3«t-100B 
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8.4.6 EXCHANGE JUMP INSTRUCTION (6000-SERIES ONLY) 

This instruction unconditionally exchange jumps the central processor, regardless of the state of the 
monitor flag bit. Instruction action differs, however, depending on whether the monitor flag bit is 
set or clear. 

Operation is as follows: 

1. Monitor flag bit clear: The starting address for the exchange is taken from the 18-bit Monitor 
Address register. This starting address is an absolute address. During the exchange, the 
monitor flag bit is set. 

2. Monitor flag bit set: The starting address for the exchange is the 18-bit result formed by adding 
K to the contents of register Bj. This starting address is an absolute address. During the 
exchange, the monitor flag bit is cleared. 

For additional information, refer to the Standard Option 10104-A/B/C/D Central and Monitor Exchange 
Jumps for 6600 Reference Manual, Pub. No. 60203200. 



The assembler forces upper before and after assembling an XJ instruction. 



Formats : 



Functional Unit: Branch 



Operation 



XJ 
XJ 
XJ 
XJ 



Variable 



Bj 
K 
Bj+K 



Examples: 

Code Generated 

01^0000000 

0130001000 
0135000600 



Description 



Exchange jump to MA if in program mode 
Exchange jump to (Bj); flag set 
Exchange jump to K; flag set 
Exchange jump to (Bj) + K; flag set 



Size 



Octal Code 



30 bits 


01300 00000 


30 bits 


013J0 00000 


30 bits 


01 3 OK 


30 bits 


013JK 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


l 




11 


18 ho 






XJ 
XJ 
XJ 


1000B 1 
85+6008 | 
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8.4.7 EXCHANGE EXIT INSTRUCTION (7600 ONLY) 

The normal termination for an exchange package execution interval is through execution of an exchange 
instruction (MJ). The exit mode flag in the PSD register determines the source of the exchange package. 

This instruction has priority over all other types of exchange jump requests. If an I/O interrupt request 
or an error exit request occurred prior to execution of this instruction, it is denied and the exchange 
jump specified by the MJ is executed. The rejected interrupt request is not lost, however. The 
conditions that caused it are reinstated when the exchange package enters its next execution interval. 

The MJ instruction voids the instruction word stack. Any instructions remaining in the stack are not 
executed. 

The system makes no protective tests on the exchange jump address. 

Exit Mode Flag Set : When the exit mode flag is set, the MJ instruction causes the current program 
sequence to terminate with an exchange jump to a relative address in the SCM field for the current 
program. The exchange package is located at relative address (Bj) + K. An overflow of the lowest 
order 16 bits of this result causes an error condition that is not sensed in the hardware. Should a 
program erroneously execute an exchange exit instruction with an overflow condition, the exchange 
jump sequence begins at the absolute SCM address corresponding to the lowest order 16 bits of this 
sum. This 30-bit form of MJ is privileged to a monitor program. 

Exit Mode Flag Not Set : When the exit mode flag is not set, the object program terminates the execution 
interval with a 15-bit form of the MJ instruction. The normal exit address (NEA) is the absolute address 
of the exchange package. This is an absolute address in SCM and is generally not in the SCM field for, 
the current program. This form of the MJ instruction has a blank variable field; the assembler sets the 
j and k designators to zero. 

This instruction is used for calling a system monitor program for input/output, monitor calls, etc. 

All operating register values, program addresses, and mode selections are preserved in the exchange 
package for the object program so that the object program can be continued at a later time. The program 
address in the object program exchange package is advanced one count from the address of the 
instruction word containing the exchange exit instruction. The monitor program normally resumes the 
object program at this address. 

The assignment of (NEA) is a responsibility of the system monitor program. If (NEA) has more than 
16 bits of significance, the upper bits are discarded and the lower 16 bits are used as the absolute 
address in SCM for the exchange jump. A force upper occurs after the instruction is assembled. 
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Formats : 



Functional Unit: None 



Operation 



MJ 
MJ 
MJ 
MJ 



Variable 



Bj 

Bj+K 

K 



Examples: 

Code Generated 

01300 

013<*000'?00 
013f 7771+17 
0130000600 



Description 



Exchange exit to NEA if exit flag clear 
Exchange exit to (Bj) if exit flag set 
Exchange exit to (Bj) + K if exit flag set 
Exchange exit to K if exit flag set 



Size 



15 bits 
30 bits 
30 bits 
30 bits 



Octal Code 



01300 

013J0 00000 
013JK 
0130K 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


30 






MJ 










MJ 


B«t + 500B 








MJ 


-300B+B6 








MJ 


600B 





8.4.8 DIRECT LCM TRANSFER INSTRUCTIONS{7600 ONLY) 

A single word transfer either reads one 60-bit word from LCM and enters this word into an X register 
or writes one 60-bit word directly into LCM from an X register. 

The execution time for transferring a word from LCM to an X register depends on whether the 
requested word already resides in one of the bank operand registers. A read LCM instruction for a 
word not currently residing in a bank operand register will require 17 clock periods for delivering a 
field of eight 60-bit words to the designated X register. A read LCM instruction for a word already 
residing in a LCM bank operand register as a result of a previous instruction will require three clock 
periods to deliver the requested word to the designated X register. Thus, although the first 60-bit 
word will require 17 clock periods, the second through eighth words in the same LCM word require 
three clock perods each. This means that consecutive LCM operands are available, on an average, 
every five clock periods as opposed to SCM operands at eight clock periods. 

The LCM address is determined from (Xki8-00)- Even if (Xk) is negative, the 19 bits are treated as 
a positive integer. If the address exceeds the field length (FLL), the word transfer does not take 
place and the LCM direct range condition flag is set in the PSD register. Xj is either the source or 
destination register. 

Instructions are buffered to the extent that each issues in one minor cycle unless a previous LCM 
reference is in process. When an RX instruction issues, the LCM busy flag is set and remains set 
until the requested word is delivered. 

For a write (WX) instruction, if the word cannot be entered immediately in the proper bank operand 
register, it is held in the LCM write register until the bank operand register is free. 
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Formats : 












Functional Unit 


None 




Operation 


Variable 


Description 


Size 


Octal Code 




RXj 
WXj 


Xk 
Xk 


Read LCM at (Xk) and set Xj 
Write (Xj) into LCM at (Xk) 


15 bits 
15 bits 


014jk 
015jk 




Examples: 


rated 










Code Gene 






LOCATION 


OPERATION 


VARIABLE 


COMMENTS 






1 




11 


18 


1 30 




01*»65 
01570 






PX6 

WX7 


X5 
X0 


1 

1 
1 







8.4.9 RESET INPUT CHANNEL BUFFER INSTRUCTION (7600 ONLY) 

This instruction is exclusively a 7600 instruction. It initiates a new record transmission from a PPU 
to SCM. This instruction prepares the input channel (Bk) buffer for a new record transmission from a 
PPU to SCM. The instruction clears the input channel buffer address and resets the input channel 
assembly counter to the first 12-bit position in the SCM word. 

This instruction is intended to be privileged to an input routine, that is, one that terminates a record 
of incoming data and prepares for the next record. 

The input routine removes the data in the input channel buffer and then executes this instruction to 
prepare the buffer for the next incoming record. This instruction is effective only if the monitor mode 
flag is set in the program status register. If the monitor mode flag is cleared, this instruction 
becomes a pass instruction. When this instruction issues, it will execute the required channel functions 
without regard to the current status or activity at the input channel buffer. 

The lowest order four bits of (Bk) are used in this instruction. The higher order bits are ignored. If 
higher order bits are set in (Bk) the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) is zero, this instruction becomes a pass instruction. 
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Two or more consecutive RI instructions referring to different channels will issue in consecutive 
clock periods with no interference resulting in the multiplexer. If two consecutive instructions refer to 
the same channel, they repeatedly perform the same function but do not cause interference in the 
multiplexer. 



Format: 



Operation 



RI 



Variable 



Bk 



Example : 

Code Gener ated 

01*07 



Description 



Reset input channel (Bk) buffer 



Functional Unit: None 



Size 



15 bits 



Octal Code 



0160k 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


[30 














PI 


°7 


1 

1 



8.4.10 SET REAL-TIME CLOCK INSTRUCTIONS (7600 ONLY) 

This instruction reads the contents of the CPU clock period counter (real-time clock) and places them in 
Bj. The 18-bit clock counter advances one count in two's complement mode for each clock period. The 
2 7 bit is the overflow bit. The CPU is interrupted when the overflow bit is set. When the interrupt 
is handled, the bit is cleared. It permits measurement of CPU execution. 



Format: 



Functional Unit: None 



Operation 



TBj 

TBj 



Variable 



K 



Example: 

Code Generated 

01670 



Description 



Set Bj to current clock time 

Set Bj to current clock time; K is ignored. 



Si7.e 



15 bits 
15 bits 



Octal Code 



OlGjO 
016J0 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ■ | 30 






TH7 


( 

1 
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8.4.11 RESET OUTPUT CHANNEL BUFFER INSTRUCTION (7600) 

This instruction initiates a new record transmission from SCM to PPU. It clears the output channel 
(Bk) buffer address and disassembly counter, transmits a record pulse over the output channel data 
path to the PPU, and initiates an SCM reference for the first word to be transmitted. 

This instruction is intended for execution in an output routine to initiate a new record transmission 
over an output channel data path. The output channel buffer is normally inactive when this instruction 
is executed. The output channel buffer is loaded with the data for the next record, and this instruction 
is executed to initiate the transmission. The record pulse is transmitted along with the word pulse as 
soon as the first word of data from the SCM is entered in the output channel disassembly register. 

This instruction is effective only if the monitor mode flag is set in the program status register. If the 
monitor mode flag is cleared, this instruction becomes a pass instruction. When this instruction issues, 
it will execute the required channel functions without regard to the current status or activity at the 
output channel. 

The lowest order four bits of (Bk) are used in this instruction. The higher order bits are ignored. If 
higher order bits are set in (Bk), the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) is zero, this instruction becomes a pass instruction. 

Normally, the output channel buffer is inactive when this instruction is executed, the program having 
checked for completion of the previous record before issuing an RO. The program can detect the end 
of record in two ways. First, it can compare the output channel buffer address with a known record 
length. The alternative is to obtain a response from the peripheral unit over the corresponding input 
channel data path. If data is moving over the output channel data path when an RO is issued, the RO 
instruction takes priority, with a resulting loss of data in the previous record. Two or more 
consecutive RO instructions referring to different channels will issue in consecutive clock periods with 
no interference resulting in the multiplexer. If two consecutive instructions refer to the same channel, 
they transmit a record pulse over the output path and restart the buffer repeatedly. A data word may 
or may not be transmitted depending on the timing of the instructions and conflicts that occur. 



Format: 



Functional Unit: None 



Operation 



RO 



Variable 



Bk 



Description 



Reset output channel (Bk) buffer 



Size 



15 bits 



Octal Code 



0170k 



Example: 



Code Generated 



017D5 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






RO 


85 ! 



60279900A 



8-21 



8.4.12 READ CHANNEL STATUS INSTRUCTIONS (7600 ONLY) 

These instructions copy the contents of the input or output channel buffer address register indicated by 
masking (Bk 03 _ Q) and enter the value in Bj. The instructions are used for monitoring the progress of 
an input channel buffer or an output channel buffer. 

A channel buffer area is divided into fields by the threshold testing mechanism. The first half of the 
buffer area constitutes one field and the last half of the buffer area the other field. An I/O multiplexer 
interrupt request is generated by the threshold testing mechanism whenever the channel buffer address 
is advanced across a field boundary. This occurs at the center of the buffer area and at the end of the 
buffer area. 

The IBj instruction is the only vehicle for a program to determine whether an I/O multiplexer interrupt 
request was generated by a buffer threshold test or by a record flag. The program must retain the 
input channel buffer address from one interrupt period to the next. If the buffer address is in the same 
field as for the previous interrupt, the interrupt request was from a record flag. If the buffer address 
is in the opposite field from the previous interrupt, the interrupt request was from a threshold test. 

The lowest order four bits of (Bk) are used in these instructions. The higher order bits are ignored. 
If higher order bits are set in (Bk) the lowest order four bits are masked out and used to determine the 
channel number. If (Bk) = 0, the IBj instruction reads the contents of the CPU clock period counter. 
However, the OBj instruction places all zeros into Bj. 

Two or more IBj instructions or OBj instructions may occur in consecutive program instruction locations 
referencing the same or different channels. These instructions may issue in consecutive clock periods 
providing the Bj register reservations do not cause a delay. No interference will result in the multi- 
plexer in these situations. 

If correct results are to be obtained, an IBj instruction must not immediately follow an RI instruction 
nor may an OBj instruction immediately follow an RO instruction. A delay of one clock period is 
sufficient. 



Formats: 



Operation 



IBj 
OBj 



Variable 



Bk 
Bk 



Description 



Bj — iRead input channel (Bk) status 
Bj —Read output channel (Bk) status 



Functional Unit: None 



Size 



15 bits 
15 bits 



Octal Code 



016jk 
017jk 



Example : 

Code Generated 

0166«* 
01756 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






IR6 
0B5 


i 

«6 j 
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8.4.13 UNCONDITIONAL JUMP INSTRUCTION 

This instruction adds the contents of index register Bi to K and branches to the relative CM (SCM) 
address specified by the sum. The remaining instructions, if any, in the current instruction word are 
not executed. The branch address is K when i is zero. 

Addition is performed in an 18-bit one's complement mode. On a 6000-Series system this instruction 
voids the stack. On a 7600, the instruction word stack is not altered by execution of this instruction. 
The instruction is intended to allow computed branch point destinations. It is the only CPU instruction 
in which a computed parameter can specify a program branch destination address. All other jump 
instructions have preassigned destination addresses at execution time. 

The assembler sets the unused j designator to 0. A force upper occurs after the instruction is 
assembled. 



Format: 



6600 Functional Unit: Branch 
7600 Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


JP 
JP 
JP 


Bi+K 

Bi 

K 


Jump to (Bi)_+K 
Jump to (Bi) 
Jump to K 


30 bits 
30 bits 
30 bits 


02iOK 

02i00 00000 
0200K 



Example : 



Code Generated 

02500052<t7 * 
0270000000 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 








| 






JP 
JP 


B5+G0T0 | 

1 
B7 | 



8.4.14 X-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 

These instructions cause the program sequence to branch to K or to continue with the current program 
sequence depending on the contents of operand register Xj. The decision is not made until the Xj 
register is free. These instructions do not void the stack. 

The following rules apply to tests made in this instruction group : 



2. 



The ZR and NZ operations test the full 60-bit word in Xj. The words 00 00 and 77 77 

are treated as zero. All other words are non-zero. Thus, these instructions are not a valid 
test for floating point zero coefficients. However, they can be used to test for underflow of 
floating point quantities. 

59 
The PL and NG operations examine only the sign bit (2 ) of Xj. If the sign bit is zero, the 

word is positive; if the sign bit is one, the word is negative. Thus, the sign test is valid for 

fixed point words or for coefficients in floating point words. 



60279900A 



8-23 



3. The IR and OR operations examine the upper-order 12 bits of Xj. 

On the 7600, the following quantities are detected as being out of range: 

3777x x (positive overflow) 

4000x x (negative overflow) 

1777x x (positive indefinite) 

6000x x (negative indefinite) 

All other words are in range. An underflow quantity is considered in range. The value of the 
coefficient is ignored in making this test. 

On a 6000-Series computer system, 3777x. . .x and 4000x. . .x are out of range; all other words 
are in range. 

4. The DF and ID operations examine the upper-order 12 bits of Xj. Both positive and 
negative indefinite forms are detected: 

1777x x and 6000x x are indefinite 

All other words are definite. The value of the coefficient is ignored in making this test. 



Formats : 



6600 Functional Unit: Branch 
7600 Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


ZR 


Xj.K 


Branch to K if (Xj) = 


30 bits 


030JK 


NZ 


Xj.K 


Branch to K if (Xj) 4 


30 bits 


031JK 


PL 


Xj.K 


Branch to K if (Xj) positive 


30 bits 


032JK 


NG 


Xj.K 


Branch to K if (Xj) negative 


30 bits 


033JK 


Ml 


Xj.K 


Branch to K if (Xj) negative 


30 bits 


033JK 


IR 


Xj.K 


Branch to K if (Xj) in range 


30 bits 


034JK 


OR 


Xj.K 


Branch to K if (Xj) out of range 


30 bits 


035JK 


DF 


Xj,K 


Branch to K if (Xj) definite 


30 bits 


036JK 


ID 


Xj,K 


Branch to K if (Xj) indefinite 


30 bits 


037JK 



8-24 
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Examples : 

Code Generated 

0305002363 + 

031300236'* + 

032^002365 + 

0331002366 + 

0331002366 + 

03^0002367 + 

0351002370 + 

0365002371 + 

0377002372 + 



LOCATION 



OPERATION 



ZR 
NZ 
PL 
NG 
MI 
IR 
OR 
UF 
IU 



VARIABLE 



COMMENTS 



I 30 



X5,ZER0 

X3, NONZERO 

X*»,PLUS 

X1,NEG 

XlfNEG 

X0,INRANGE 

X1,0UTRNGE 

X5.0EFINT 

X7,INU£FNT 



60279900B 



8-24-1 



8.4.15 B-REGISTER CONDITIONAL BRANCH INSTRUCTIONS 

These instructions test an 18-bit word from register Bi against an 18-bit word from register Bj for the 
condition specified. They branch to address K on a successful test. Otherwise, the program sequence 
continues at the next instruction. The decision is not made until both B registers are free. For the 
tests against zero (all zeros), the assembler sets either the i or the j designator to indicating BO. 

The following rules apply in the tests made by these instructions: 

1. Positive zero is recognized as unequal to negative zero, and 

2. Positive zero is recognized as greater than negative zero, and 

3. A positive number is recognized as greater than a negative number. 

The 06 and 07 instructions are intended for branching on an index threshold test. The tests are made in 
a 19-bit one's complement mode. The (Bi) and the (Bj) are sign extended one bit to prevent erroneous 
results caused by exceeding the modulus of the comparison device. The (Bj) is then subtracted from the 
(Bi). The branch decision is based on the sign bit in the 19-bit result. 

For these instructions, Bi and Bj must be specified in the order indicated below. 

These instructions do not void the stack. 

6600 Functional Unit: Branch 
Formats: 7600 Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


ZR + 


K 


Branch to K 


30 bits 


040 OK 


ZR 


Bi.K 


Branch to K if (Bi) = 


30 bits 


04iOK 


EQt 


K 


Branch to K 


30 bits 


0400K 


EQ 


Bi.K 


Branch to K if (Bi) = 


30 bits 


04i0K 


EQ 


Bi,Bj,K 


Branch to K if (Bi) = (Bj) 


30 bits 


04ijK 


NE 


Bi,K 


Branch to K if (Bi) 4 


30 bits 


05i0K 


NE 


Bi,Bj,K 


Branch to K if (Bi) 4 (Bj) 


30 bits 


05ijK 


NZ 


Bi.K 


Branch to K if (Bi) 4 


30 bits 


05iOK 


PL 


Bi,K 


Branch to K if (Bi) > 


30 bits 


06iOK 


GE 


Bi.K 


Branch to K if (Bi) > 


30 bits 


06iOK 


GE 


Bi.Bj.K 


Branch to K if (Bi) > (Bj) 


30 bits 


06ijK 


LE 


Bj,Bi,K 


Branch to K if (Bj) < (Bi) 


30 bits 


06ijK 


LE 


Bj,K 


Branch to K if (Bj) < 


30 bits 


060JK 


NG 


Bi.K 


Branch to K if (Bi) < 


30 bits 


07iOK 


MI 


Bi,K 


Branch to K if (Bi) < 


30 bits 


07iOK 



t The assembler forces the position counter upper after assembling the instructions. 
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Formats (cont'd): 



Operation 


Variable 


Description 


Size 


Octal Code 


GT 


Bj.Bi.K 


Branch to K if (Bj) > (Bi) 


30 bits 


07ijK 


GT 


Bj,K 


Branch to K if (Bj) >0 


30 bits 


070JK 


LT 


Bi.K 


Branch to K if (Bi) < 


30 bits 


07iOK 


LT 


Bi.Bj.K 


Branch to K if (Bi) < (Bj) 


30 bits 


07ijK 



Examples: 

Code Generated 

01*50005221 «■ 

0405005222 + 

0453005223 + 

0400005223 + 

0515005224 + 

0560005225 <• 

0620005226 •«■ 

0645005227 ♦ 

0650005230 + 

0676005231 ♦ 

0770005232 + 

0730005233 + 

0767005234 ♦ 

0705005235 «• 

0712005236 + 



LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 


11 


18 |30 




ZR 


B5,BZER0 | 




EQ 


80, 05, EQUAL | 




EQ 


B5,B3,JUMP | 




EQ 


JUMP 




NE 


B1,B5,N0TEQ ' 




NZ 


B6,BN0TZR 1 




PL 


B2,BPLUS | 




GE 


B4,B5,GEQ 




GE 


85,GEB0 1 




LE 


B6,B7,LTHAN | 




NG 


87,BNEG 




MI 


83,B3LT0 




GT 


B7,B6,B7GT [ 




GT 


B5,B5GT0 1 




LT 


B1,B2,BLTB 1 
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8.4.16 TRANSMIT INSTRUCTION 

This instruction, transfers the 60-bit word in operand register Xj to register Xi. It is essentially a 
copy instruction intended for moving data from X register to X register as quickly as possible. No 
logical function occurs. The assembler sets the k designator to the value specified for j. 



Format: 



6600 Functional Unit: Boolean 
7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj 


Transmit (Xj) to Xi 


15 bits 


lOijj 



Example: 

Code Generated 

10622 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 














BX6 


X2 ! 



8.4.17 LOGICAL PRODUCT INSTRUCTION 

This instruction forms the logical product (AND function) of 60-bit words from operand registers Xj and 
Xk and places the product in operand register Xi. Bits of register Xi are set to 1 when the corresponding 
bits of the Xj and Xk registers are 1 as in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = 0100 

This instruction is intended for extracting portions of a 60-bit word during data processing. If the j and 
k designators have the same value, the instruction becomes a transmit instruction. 

6600 Functional Unit: Boolean 



Format: 



7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj*Xk 


Logical product of (Xj) and (Xk) to Xi 


15 bits 


llijk 



Example : 

Code Generated 

11553 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 








| 






BX5 


X5*X3 i 
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8.4.18 LOGICAL SUM INSTRUCTION 

This instruction forms the logical sum (inclusive OR) of 60-bit words from operand registers Xj and 
Xk and places the sum in operand register Xi. A bit of register Xi is set to 1 if the corresponding bit 
of the Xj or Xk register is a 1 as in the following example: 



(Xj) = 0101 
(Xk) = 1100 
(Xi) = 1101 

This instruction is intended for merging portions of a 60-bit word into a composite word during data 

processing. If the j andk designators have the same value, the instruction degenerates into a transmit 

instruction. 

6600 Functional Unit: Boolean 

Format: 7000 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj+Xk 


Logical sum of (Xj) and (Xk) to Xi 


15 bits 


12ijk 



Example : 

Code Generated 

12767 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 ! 30 














RX7 


X6 + X7 i 



8.4.19 LOGICAL DIFFERENCE INSTRUCTION 

This instruction forms the logical difference (exclusive OR) of 60-bit words from operand registers 
Xj and Xk and places the difference in operand register Xi. A bit in register Xi is set to 1 if the 
corresponding bits in the Xj and Xk registers are unlike as in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = 1001 



This instruction is intended for comparing bit patterns or for complementing bit patterns during data 
processing. If the j and k designators have the same value the result will be a word of all zeros written 
into register Xi. 

6600 Functional Unit: Boolean 
Format: 7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


Xj-Xk 


Logical difference of (Xj) and (Xk) to Xi 


15 bits 


13ijk 



Example: 

Code Generated 

13601 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


I 30 








i 






BX6 


X0-X1 


1 



8-28 
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8.4.20 COMPLEMENT INSTRUCTION 

This instruction extracts the 60-bit word from operand register Xk, complements it, and transmits this 
complemented quantity to operand register Xi. It is intended for changing the sign of a fixed point or 
floating point quantity as quickly as possible. 



The assembler sets the unused j designator of the instruction to k. 
Format: 



6600 Functional Unit: Boolean 
7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xk 


Transmit complement of (Xk) to Xi 


15 bits 


14ikk 



Example : 

Code Generated 

Hf3ii 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ho 








1 






BX3 


-XI J 



8.4.21 LOGICAL PRODUCT AND COMPLEMENT INSTRUCTION 

This instruction forms the logical product (AND function) of the 60-bit quantity from operand register 
Xj and the complement of the 60-bit quantity from operand register Xk, and places the result in operand 
register Xi. Thus, bits of Xi are set to 1 when the corresponding bits of the Xj register and the comple- 
ment of the Xk register are 1 as in the following example: 

(Xj) = 0101 

Complemented (Xk) = 0011 

(Xi) = 0001 

This instruction is intended for extracting portions of a 60-bit word during data processing. If the j and 
k designators have the same value, a logical product is formed between two complementary quantities. 
The result will be a word of all zeros. 

6600 Functional Unit: Boolean 
Format: 7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xk*Xj 


Logical product of (Xj) and complement 
of (Xk) to Xi 


15 bits 


15ijk 



Examples: 



Code Generated 



15«t32 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 














PXk 


-X2*X3 i 
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8.4.22 COMPLEMENT AND LOGICAL SUM INSTRUCTION 

This instruction forms the logical sum (inclusive OR) of the 60-bit quantity from operand register 
Xj and the complement of the 60-bit word from operand register Xk, and places the result in operand 
register Xi. Thus, bits of Xi are set to 1 if the corresponding bit of the Xj register is one or the 
corresponding bits of the Xk register is a as in the following example: 

(Xj) = 0101 
(Xk) = 1100 



(Xi) = 0111 

This instruction is intended for merging portions of a 60-bit word into a composite word during data 
processing. If the j and k designators have the same value the result is a word of all ones. 

6600 Functional Unit: Boolean 
Format: 7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xk+Xj 


Logical sum of (Xj) and complement of 
(Xk) to Xi 


15 bits 


16ijk 



Example : 

Code Generated 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 






BX6 


-Xif+XS | 



8.4.23 COMPLEMENT AND LOGICAL DIFFERENCE INSTRUCTION 

This instruction forms the logical difference (exclusive OR) of the quantity from operand register Xj 
and the complement of the 60-bit word from operand register Xk, and places the result in operand 
register Xi. Thus, bits of Xi are set to 1 if the corresponding bits of Xj and register Xk are alike as 
in the following example: 

(Xj) = 0101 
(Xk) = 1100 
(Xi) = 0110 

This instruction is intended for comparing bit patterns or for complementing bit patterns during data 
processing. If the j and k designators have the same value, a logical difference is formed between two 
complementary quantities. The result is a word of all ones. 

6600 Functional Unit: Boolean 
Format: 7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


BXi 


-Xk-Xj 


Logical difference of (Xj) and complement 
of (Xk) to Xi 


15 bits 


171jk 
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Example : 

Code Generated 
17731 



LOCATION 



OPERATION 



BX7 



VARIABLE 



-X1-X3 



COMMENTS 



I 30 



8.4.24 LOGICAL LEFT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi left circular jk places if expression jk is 
positive or left circular 60-jk places if jk is negative. Bits shifted off the left end of operand register 
Xi replace those shifted from the right end. 

The 6-bit shift count jk allows a complete circular shift of (Xi). 

In COMPASS notation, jk is an absolute expression. If it is positive, COMPASS places the lower 6 bits 
on the value in the jk fields. If it is negative, COMPASS subtracts jk from 60 and places the result in 
the jk fields. Thus, a negative value effectively designates a logical right shift. A positive value 
designates a left shift. 

If the negative shift count is less than -60, the assembler generates a 7-type error. 

6600 Functional Unit: Shift 
Format: 7600 Functional Unit: Shift 



Operation 


Variable 


Description 


Size 


Octal Code 


LXi 


jk 


Logical shift (Xk) by + jk places 


15 bits 


20ijk 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


i 




11 


18 1 30 








1 






LX3 
LX3 


2.5B j 

1 

-12B I 

1 



Example : 

Code Generated 
20325 

8.4.25 ARITHMETIC RIGHT SHIFT jk PLACES INSTRUCTION 

This instruction shifts the 60-bit word in operand register Xi right jk places if expression jk is positive 
and right 60-jk places if expression jk is negative. The rightmost bits of Xi are discarded and the sign 
bit is extended. 

If the shift count is equal to the 60-bit register length, the result contains 60 copies of the sign bit. If 
the operand is positive, a positive zero results. If the operand is negative, a negative zero results. 

In COMPASS notation, jk is an absolute expression. If it is positive, COMPASS places the lower 
6 bits of the value in the jk fields. If it is negative, COMPASS subtracts jk from 60 and places the 
result in the jk fields. Thus, a negative value effectively designates the number of high order bits 
of the operand that are to be retained. If the negative shift count is less than -60, a 7-type error is 
generated. 
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Format: 



6600 Functional Unit: Shift 
7600 Functional Unit: Shift 



Operation 


Variable 


Description 


Size 


Octal Code 


AXi 


jk 


Arithmetic shift (Xk) by + jk places 


15 bits 


21ijk 



Example : 

Code Generated 

21537 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 | 30 














AX5 


37B I 



8.4.26 LOGICAL LEFT SHIFT (Bj) PLACES INSTRUCTION 

This instruction shifts the 60-bit quantity from operand register Xk the number of places specified by 
the quantity in index register Bj and places the result in operand register Xi. 

1. If (Bj) is positive (i.e. , bit 17 of Bj = 0), the quantity from Xk is shifted left circular. The low 
order six bits of (Bj) specify the shift count. The higher order bits are ignored. 

2. If (Bj) is negative (i.e. , bit 17 of Bj = 1), the quantity from Xk is shifted right (end off with sign 
extension). The one's complement of the low order 12 bits of (Bj) specify shift count. The 
higher order bits are ignored. If the shift count is greater than 60 (decimal) the result stored 
in the Xi register consists of 60 copies of the operand sign bit. 

The (Bj) might be the result of an unpack instruction; in which case it is the unbiased exponent and (Xi) 
is the coefficient. This instruction is used for shifting a coefficient from a floating point number to the 
integer position after an unpack operation. 

6600 Functional Unit: Shift 
7600 Functional Unit: Shift 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


LXi 
LXi 
LXi 


Xk,Bj 
Bj.Xk 
Xk 


Logically shift (Xk) by (Bj) places to Xi 
Logically shift (Xk) by (Bj) places to Xi 
Transmit (Xk) to Xi 


15 bits 
15 bits 
15 bits 


22ijk 
22ijk 
22i0k 



Example: 

Code Generated 

22675 
2253«f 



LOCATION 



OPERATION 



II 



LX6 
LX5 



VARIABLE 



COMMENTS 



130 



X5.B7 
83, Xi* 
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8.4.27 ARITHMETIC RIGHT SHIFT (Bj) PLACES INSTRUCTION 

This instruction shifts the 60-bit quantity from operand register Xk the number of places specified by 
the quantity in index register Bj and places the result in operand register Xi. 

1. If (Bj) is positive (i. e. , bit 17 of Bj = 0), the quantity from register Xk is shifted right (end 
off with sign extension). The lower order 12 bits of (Bj) specify the shift count. The higher 
order bits are ignored. If the shift count is greater than 60 (decimal) the 7600 result stored 
in the Xi register consists of 60 copies of the operand sign bit. The 6000 series result con- 
sists of all zeros. 

2. If (Bj) is negative (i.e. , bit 17 of Bj = 1), the quantity from register Xk is shifted left circular. 
The complement of the lower order six bits of Bj specify the shift count. The higher order bits 
are ignored. 

This instruction is intended for use in data processing where the amount of shift is derived in the 
computation. This instruction is also useful for adjusting the coefficient of a floating point number 
while it is in its unpacked form. 

6600 Functional Unit: Shift 
Format: 7600 Functional Unit: Shift 



Ope ration 


Variable 


Description 


Size 


Octal Code 


AXi 


Xk.Bj 


Arithmetic shift of (Xk) by (Bj) places 










to Xi 


15 bits 


23ijk 


AXi 


Bj.Xk 


Arithmetic shift of (Xk) by (Bj) places 










to Xi 


15 bits 


23ijk 


AXi 


Xk 


Transmit (Xk) to Xi 


15 bits 


23i0k 



Example: 

Code Generated 



? -* 7 f-.it 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 Uo 














flX7 
CX? 


xu,pm : 

1 

m,xi i 



8.4.28 NORMALIZE INSTRUCTION 

This instruction normalizes the floating point, quantity from operand register Xk and places it in 
ope mini register Xi. Normalizing consists of shifting the coefficient the minimum number of positions 
required to make bit -17 different from bit 59. This places the most significant bit of the coefficient 
in the highest order position of the coefficient portion of the word. The exponent portion of the word 
is then decreased by the number of bit positions shifted. The number of shifts required to normalize 
the quantity is entered in index register Bj. 
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Format: 



Operation 



NXi 
NXi 

NXi 



6600 Functional Unit: Shift 
7600 Functional Unit: Normalize 



Variable 



Xk 

Bj.Xk 

Xk,Bj 



Description 



Example : 

Code Generated 

2«*575 
2<t505 
2«f55? 



Normalize (Xk) to Xi 

Normalize (Xk) to Xi; shift count to Bj 

Normalize (Xk) to Xi; shift count to Bj 



Size 



15 bits 
15 bits 
15 bits 



Octal Code 



24i0k 
24ijk 
24ijk 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 j 30 






M5 
MX5 
NX5,B5 


X5,B7 j 
X5 1 

1 

X2 1 



8.4.29 ROUND AND NORMALIZE INSTRUCTION 

This instruction performs the same operation as the NXi instruction with the exception that the quantity 
from operand register Xk is rounded before it is normalized. Rounding is accomplished by placing a 
1 round bit immediately to the right of the least significant coefficient bit. The resulting coefficient is 
increased by one-half the value of the least significant bit. Normalizing a zero coefficient places the 
round bit in bit 47 and reduces the exponent by 48. Note that the same rules apply for underflow, overflow, 
infinite, and indefinite results. 

If (Xk) is an infinite quantity (3777x. . . x or 4000x. . . x) or an indefinite quantity (1777x. . . x or 6000x. . . x), 
no shift takes place. The contents of Xk are copied into Xi, and Bj is set to zero. 



Formats : 



Operation 



ZXi 
ZXi 

ZXi 



6600 Functional Unit : Shift 
7600 Functional Unit: Normalize 



Variable 



Xk 
Bj.Xk 

Xk.Bj 



Description 



Round and normalize (Xk) to Xi 

Round and normalize (Xk) to Xi; shift 
count to Bj 

Round and normalize (Xk) to Xi; shift 
count to Bj 



Size 



15 bits 
15 bits 
15 bits 



Octal Code 



25i0k 
25ijk 
25ijk 
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Example : 


Code Generated 


?5^7«f 


25<*n«* 


25361 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


i 




11 


18 


30 






7X«* 


X*f,P7 








7Xi» 


X<* 








ZX3,R6 


XI 





8.4.30 UNPACK INSTRUCTION 

This instruction unpacks the floating point quantity from operand register Xk and sends the 48-bit 
coefficient to operand register Xi and the 11-bit exponent to index register Bj. The exponent packing 
is removed during unpack so that the quantity in Bj is the true one's complement representation of the 
exponent* The contents of Xk need not be normalized. 

The exponent and coefficient are sent to the low-order bits of the respective registers as shown below: 

SIGN PACKED EXPONENT COEFFICIENT 



PACKED QUANTITY 



59 58 



48 



UNPACKED 
EXPONENT 



00 



EXPONENT SIGN 

EXTENDED 

UNPACKED Bj 



COEFFICIENT 
SIGN EXTENDED 



m 



Xi 



17 10 9 59 48 47 

Special operand formats are treated in the same manner as normal operands. 



Formats : 



6600 Functional Unit: Shift 
7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


UXi 

UXi 
UXi 


Xk 

Bj.Xk 

Xk,Bj 


Unpack (Xk) to Xi 
Unpack (Xk) to Xi and Bj 
Unpack (Xk) to Xi and Bj 


15 bits 
15 bits 
15 bits 


26i0k 
26ijk 
26ijk 



Example : 

Code Generated 

26777 
2hZh?_ 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






UX7 
UX3,X2 


X7,B7 j 
B** J 
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8.4.31 PACK INSTRUCTION 

This instruction packs a floating point number in operand register Xi. The coefficient of the number is 
obtained from operand register Xk and the exponent is obtained from index register Bj. The exponent is 
packed by toggling bit 2 during the pack operation. The instruction does not normalize the coefficient. 

Exponent and coefficient are obtained from the proper low-order bits of the respective registers and 
packed in reverse order as shown in the illustration for the unpack instruction. Thus, bits 58-48 of 
Xk and bits 17-11 of Bj are ignored. There is no test for overflow or underflow. No flags are set in the 
PSD register by this instruction. 



Note that if (Xk) is positive, the packed exponent occupying Xi 5g _ 48 is obtained from Bj^o-OO by 
complementing bit 10; if (Xk) is negative, t bit 10 is not complemented but bits 09-00 are complemented. 

The j designator may be set to zero in this instruction to pack a fixed point integer into floating point 
format without using one of the active B registers (exponent = 0). 

6600 Functional Unit: Shift 
Format: 7600 Functional Unit: Boolean 



Operation 


Variable 


Description 


Size 


Octal Code 


PXi 
PXi 
PXi 


Xk 

Xk, Bj 
Bj, Xk 


Pack (Xk) to Xi 

Pack (Xk) and (Bj) to Xi 

Pack (Xk) 


15 bits 
15 bits 
15 bits 


27i0k 
27ijk 
27ijk 



Example : 

Code Generated 

27565 
27671 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 [ 30 






PX5 
PX6,B7 


X5,B6 J 

I 



8.4.32 UNROUNDED SP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the unrounded sum or difference of the floating point quantities from operand 
registers Xj and Xk and pack the result in operand register Xi. The packed result is the upper half of 
a double precision sum or difference. 

At the start both arguments are unpacked, and the coefficient of the argument with the smaller exponent 
is entered into the upper half of the accumulator. The coefficient is shifted right by the difference 
of the exponents. The other coefficient is then added to or subtracted from the upper half of the 
accumulator. If overflow occurs, the result is right-shifted one place and the exponent of the result 
increased by one. The upper half of the accumulator holds the coefficient of the result, which is not 
necessarily in normalized form. The exponent and upper coefficient are then repacked in operand 
register Xi. 



8-36 



60279900B 



Formats : 












660Q Functional Unit: Floating Add 
7600 Functional Unit: Floating Add 


Operation 


Variable 


Desc 


ri 

ti 

ti 
t( 


iption 


Size 


Octal Code 


FXi 
FXi 


Xj+Xk 
Xj-Xk 


Floa 

Floa 
(Xk) 


ng point sum of (Xj) and (Xk) to Xi 

ng point difference of (Xj) minus 
3 Xi 


15 bits 
15 bits 


30ijk 
31ijk 


Examples : 


rated 






Code Gene 






LOCATION 


OPERATION 


VARIABLE COMMENTS 




i 


- 


11 


18 1 30 


303i*5 

31213 






FX3 
FX2 


X^ + XS ' 

1 

X1-X3 ' 







8.4.33 DP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the sum or difference of two floating point numbers as in the single precision 
instructions, but pack, the lower half of the double precision result with an exponent 48 less than the 
upper sum. The result is not necessarily normalized. 



Formats : 



Operation 



DXi 
DXi 



Variable 



Xj+Xk 
Xj-Xk 



6600 Functional Unit: Floating Add 
7600 Functional Unit: Floating Add 



Description 



Floating DP sum of (Xj) and (Xk) to Xi 

Floating DP difference of (Xj) and (Xk) 
to Xi 



Size 



15 bits 
15 bits 



Octal Code 



32ijk 
33ijk 



Examples: 

Code Generated 

32323 
33V1<* 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






0X3 

nxt» 


X2+X3 J 

xi-yif i 



60279900A 
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8.4.34 ROUNDED SP FLOATING POINT ADD INSTRUCTIONS 

These instructions form the rounded sum or difference of the floating point quantities from operand 
registers Xj and Xk and pack the upper portion of the double precision result in operand register Xi. 
These instructions are intended for use in floating point calculations involving single precision 
accuracy. 

6600 Functional Unit: Floating Add 



Formats : 




7600 


Functional 


Unit: Floating Add 


Operation 


Variable 


Description 


Size 


Octal Code 


RXi 
RXi 


Xj+Xk 
Xj-Xk 


Rounded floating sum of (Xj) and (Xk) 
toXi 

Rounded floating difference of (Xj) minus 
(Xk) to Xi 


15 bits 
15 bits 


34ijk 
35ijk 



Examples: 



Code Generated 
35653 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 






RX5 
RX6 


1 1 

X3+XU 1 

1 
X5-X3 | 



8.4.35 LONG ADD (FIXED POINT) INSTRUCTIONS 

These instructions form the 60-bit onefe complement integer sum or integer difference of quantities from 
operand registers Xj and Xk and store the result in operand register Xi. An overflow condition is 
ignored. 

The instructions are intended for addition or subtraction of integers too large for handling in the 
increment unit. They are also useful for merging and comparing data fields during data processing. 

For an addition, if both operands are zero, the result is zero. If either zero operand is positive zero 
(all 0's), the result is a positive zero quantity. If both operands are minus zero (all l's), the result 
is a negative zero quantity. 
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Format: 



Operation 



IXi 

IXi 



Example: 



6600 Functional Unit: Long Add 
7600 Functional Unit: Long Add 



Variable 



Xj+Xk 
Xj-Xk 



Description 



Integer sum of (Xj) and (Xk) to Xi 

Integer difference of (Xj) minus (Xk) 
to Xi 



Code Generated 

36545 
37631 



Size 



15 bits 



15 bits 



Octal Code 



36ijk 
37ijk 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 |30 






1X5 

1X6 


1 

X4+X5 | 

1 
X3-X1 | 



8.4.36 UNROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies two floating point quantities obtained from operand registers Xj (multiplier) 
and Xk (multiplicand) and packs the upper product result in operand register Xi. 

In this operation, the exponents of the two operands are unpacked from the floating point format and are 
added with a correction factor of 48 to form the exponent for the result. The coefficients are multiplied 
as signed integers to form a 96-bit integer product. The upper half of this product is then extracted 
to form the coefficient of the result. The result is a normalized quantity only when both operands are 
normalized; the exponent in this case is the sum of the exponents plus 47 (or 48). The result is not 
normalized when either or both operands are not normalized. 



Formats : 




6600 Functional Unit: 
7600 Functional Unit: 


Floating Multiply 
Floating Multiply 


Operation 


Variable 


Description 


Size 


Octal Code 


FXi 


Xj*Xk 


Floating point product of (Xj) and 
(Xk) to Xi 


15 bits 


40ijk 



Example : 



Code Generated 



40011 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 






FXO 


X1*X1 I 

1 



60279900A 
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8.4.37 ROUNDED SP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies the floating point number from operand register Xk (multiplicand), by the 
floating point number from operand register Xj. The upper product result is packed in operand 
register Xi. (No lower product is available. ) The multiply operation is identical to that of the single 
precision instruction except that a rounding bit is added in bit position 46 of the 96-bit product. The 
upper half of the product is then extracted to form the coefficient for the result. An alternate output 
path is provided with a left shift of one-bit position to normalize the result coefficient if the original 
operands were normalized and the double precision product has only 95 bits of significance. The 
exponent for the result is decremented by one count in this case. 



Format: 



6600 Functional Unit: Floating Multiply 
7600 Functional Unit: Floating Multiply 



Operation 


Variable 


Description 


Size 


Octal Code 


RXi 


Xj*Xk 


Rounded floating point product of (Xj) 
and (Xk) to Xi 


15 bits 


41ijk 



Example: 



Code Generated 



U1232 



LOCATION 



OPERATION 



RX2 



VARIABLE 



X3*X? 



COMMENTS 



130 



8.4.38 DP FLOATING POINT MULTIPLY INSTRUCTION 

This instruction multiplies two floating point quantities obtained from operand registers Xj and Xk 
and packs the lower product in operand register Xi. The two 48-bit coefficients are multiplied together 
to form a 96-bit product. The lower-order 48 bits of this product (bits 47-00) are then packed together 
with the resulting exponent. The result is not necessarily normalized. The exponent of this result is 
48 less than the exponent resulting from an unrounded single precision instruction using the same 
operands. 

This instruction is intended for use in multiple precision floating point calculations. It may also be 
used to form the product of two integers providing the resulting product does not exceed 48 bits of 
significance. The operands must be packed in floating point format before executing this instruction. 
The results must be unpacked to obtain the integer product. 



Format: 



6600 Functional Unit: Floating Multiply 
7600 Functional Unit: Floating Multiply 



Operation 


Variable 


Description 


Size 


Octal Code 


DXi 


Xj*Xk 


Floating point DP product of (Xj ) and 
(Xk) to Xi 


15 bits 


42ijk 



8-40 
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Example: 
Code Generated 

<*2 3»»5 



LOCATION 



OPERATION 



DX3 



VARIABLE 



X<t »X5 



COMMENTS 



8.4.39 INTEGER MULTIPLY INSTRUCTION 

The CPU integer multiply instruction is, to COMPASS, synonymous with the double precision 
floating point multiply instruction. Regardless of how it is written in COMPASS, the 42ijk 
instruction is executed as follows: If each operand register has all O's or all l's in its leftmost 
12 bits, the 48-bit integer product is formed in Xi with sign extension in its leftmost 12 bits. 
(Exception: If each operand has bit 24V different from its sign bit, the result is shifted left one 
bit position.) Otherwise, a double precision floating point multiplication is performed. Thus, 
there is no need to pack exponents into the operands and unpack the result for an integer multiply. 
COMPASS provides the alternate symbolic representations DCi Xj*Xk and DXi Xj*Xk for the 42ijk 
instruction as an aid to program readability, so the programmer can indicate whether the instruc- 
tion is being used for integer multiplication. 



Format: 



6600/6700 Functional Unit: Floating Multiply 
or 7600 Functional Unit: Floating Multiply 



Operation 


Variable 


Description 


Size 


Octal Code 


Ki 

. __ 


Xj*Xk 


Integer product of (Xj) and (Xk) to Xi 


15 bits 


42ijk 



Example: 

Code Generate d 

t*2Z3k 



LOCATION 



OPERATION 



1X2 



VARIABLE 



COMMENTS 



130 



X3»X<* 



8.4.40 MASK INSTRUCTION 

This instruction clears register Xi and forms a mask in it. A positive value for expression jk 
defines the number of l's in the mask as counted from the highest order bit in Xi. A nega- 
tive value for expression jk defines the number of bits (unmasked) counted from the low order 
bit in Xi. The completed masking word consists of l's in the high order bit positions of the 
word and O's in the remainder of the word. 



60279900D 



8-41 



The contents of operand register i are zero when jk is zero. The contents of operand register i 
are all l's when jk is 60. 

This instruction is intended for generated variable width masks for logical operations. Used with the 
shift instruction, this instruction creates an arbitrary field mask faster than by reading a pregenerated 
mask from storage. 

In COMPASS notation, if the value of absolute expression jk is positive, the assembler inserts it into 
the jk field of the assembled instruction. If the value of absolute expression jk is negative, the 
assembler subtracts the expression value from 60 and places the difference in the jk field of the 
assembled instruction. 

A negative jk value less than -60 results in a 7-type assembly error. 

An MXi is the fastest instruction for clearing an X register. 



Format: 



6600 Functional Unit: Shift 
7600 Functional Unit: Shift 



Operation 


Variable 


Description 


Size 


Octal Code 


MXi 


jk 


Form mask in Xi, + jk bits 


15 bits 


43ijk 



Example: 

Code G enerated 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 














MX3 


» I 

i 



| 8.4.41 UNROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 

This instruction divides two normalized floating point quantities obtained from operand registers Xj 
(dividend) and Xk (divisor) and packs the quotient in operand register Xi. 



Format: 



Operation 



FXi 



Variable 



Xj/Xk 



6600 Functional Unit: Floating Divide 
7600 Functional Unit: Floating Divide 



Description 



Floating point divide of (Xj) by (Xk) 
to Xi 



Size 



15 bits 



Octal Code 



44ijk 



Example: 

Code Generated 

«♦ 1*671 



LOCATION 



OPERATION 



FX6 



VARIABLE 



X3/X1 



COMMENTS 



8-42 
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8.4.42 ROUNDED SP FLOATING POINT DIVIDE INSTRUCTION 

This instruction divides the floating quantity from operand register Xj (dividend) by the floating point 
quantity from operand register Xk (divisor) and packs the rounded quotient in operand register Xi. 



Format: 



6600 Functional Unit: Floating Divide 
7600 Functional Unit: Floating Divide 



Ope ration 


Variable 


Description 


Size 


Octal Code 


RXi 


Xj/Xk 


Rounded floating point division of (Xj) 
by (Xk) to Xi 


15 bits 


45ijk 

— . . -- . ... 



Example: 

Code Generated 
i»<572(* 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ho 






RX7 


X2/X<+ J 



8.4.43 PASS INSTRUCTION 



The no-operation (pass) instruction is not associated with a functional unit. This instruction is a do- 
nothing instruction used typically to pad the program between steps. An integer value in the variable 
field (optional) is inserted into the lower 9 bits of the instruction. The assembler automatically pads 
the remainder of a word whenever a force upper occurs; in this case, the programmer is not required 
to insert the NO. 



Format: 



6600 Functional Unit: None 
7600 Functional Unit: None 



Operation 


Variable 


Description 


Size 


Octal Code 


NO 
NO 


n 


Pass 
Pass 


15 bits 
15 bits 


46000 
46n 



Example : 

Code Generated 

if6000 



LOCATION 



OPERATION 



NO 



VARIABLE 



130 



60279900D 
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I 8.4.44 POPULATION INSTRUCTION 



i^,r ?^ n:,^™ t— » - » — — 



delivered to the Xi register. 
The assembler sets the unused j designator to k. 
Formats: 



is a 



Operation 



CXi 



Variable 



Xk 



6000 Functional Unit: Floating Divide 
7600 Functional Unit: Population Count 



Description 



Count of number of l's in (Xk) to Xi 



Size 



15 bits 



Octal Code 



47ikk 



Example : 

Code Generated 



LOCATION 



OPERATION 



TX7 



VARIABLE 



COMMENTS 



30 



XO 



| 8.4.45 SET A REGISTER INSTRUCTIONS 



These instructions are intended for fetching operands from storage for computation and for delivering 
results back into storage. The instructions have two destination registers: the Ai register which 
receives the address formed from the operands and either the Xi register or a CM (SCM) storage location. 

If the i designator is nonzero, a storage reference is made using the lower 15, 16, or 17 bits of the 
resulting sum or difference as the relative storage address depending on machine size. The upper 
bits are ignored. The type of storage reference is a function of the i designator value. 

i = 0; no storage reference 

i = 1, 2, 3, 4, or 5; contents of CM (SCM) relative address (Ai) to register Xi 

i = 6 or 7; contents of register Xi stored at CM (SCM) relative address (Ai) 
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Formats : 



6600 Functional 
7600 Functional 



Unit: Increment 
Unit: Increment 



Operation 


Variable 


Description 


Size 


Octal Code 


SAi 


Aj+K 


Set Ai to (Aj).+ K 


30 bits 


50ijK 


SAi 


K 


Set Ai to K 


30 bits 


51i0K 


SAi 


Bj+K 


Set Ai to (Bj) + K 


30 bits 


51ijK 


SAi 


Xj+K 


Set Ai to (Xj) + K 


30 bits 


52ijK 


SAi 


Xj 


Set Ai to (Xj) 


15 bits 


53ij0 


SAi 


Xj+Bk 


Set Ai to (Xj) + (Bk) 


15 bits 


53ijk 


SAi 


Bk+Xj 


Set Ai to (Xj) + (Bk) 


15 bits 


53ijk 


SAi 


Aj 


Set Ai to (Aj) 


15 bits 


54ij0 


SAi 


Aj+Bk 


Set Ai to (Aj) + (Bk) 


15 bits 


54ijk 


SAi 


Bk+Aj 


Set Ai to (Aj) + (Bk) 


15 bits 


54ijk 


SAi 


Aj-Bk 


Set Ai to (Aj) - (Bk) 


15 bits 


55ijk 


SAi 


-Bk+Aj 


Set Ai to (Aj) - (Bk) 


15 bits 


55ijk 


SAi 


Bj 


Set Ai to (Bj) 


15 bits 


56ij0 


SAi 


Bj+Bk 


Set Ai to (Bj) + (Bk) 


15 bits 


56ijk 


SAi 


-Bk 


Set Ai to (BO) - (Bk) 


15 bits 


57i0k 


SAi 


Bj-Bk 


Set Ai to (Bj) - (Bk) 


15 bits 


57ijk 


SAi 


-Bk+Bj 


Set Ai to (Bj) - (Bk) 


15 bits 


57ijk 



Examples: 

Code Generated 

5010000001 

510<177777<t 

5121000003 

5231777771 

53M1 

5«*5<»1 

5<*6M 

5«*5«»0 

556^1 

56711 

57721 

60279900D 





LOCATION 


OPEKATION 


VARIABLE 


COMMENTS 


1 




II 


18 


30 






SAi 


AQ«-1 








SAO 


-3 








SA2 


3+Bi 








SA3 


Xl-6 








SA«t 


Xl+Bl 








SA5 


A<» + B1 








SA6 


A«f*Rl 








SA5 


A!* 








SA6 


-Bl + A<* 








SA7 


Bl + Bl 








SA7 


B2-R1 
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8.4.46 SET B REGISTER INSTRUCTIONS 

These instructions perform one's complement addition and subtraction of 18-bit operands and store an 
18-bit result in index register Bi. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as from the 
instruction itself (K = 18-bit operand). Operands obtained from an Xj operand register are the 
truncated lower 18 bits of the 60-bit word. The highest order bits are ignored; an overflow condition 
is also ignored. 



If the i designator is a zero, the instruction is a do-nothing instruction. 



6600 Functional Unit: Increment 



Formats: 






7600 Functional Unit: Increment 


Operation 


Variable 


Description 


Size 


Octal Code 


SBi 


Aj+K 


Set Bi to (Aj) + K 


30 bits 


60ijK 


SBi 


K 


Set Bi to K 


30 bits 


61iOK 


SBi 


Bj-^K 


Set Bi to (Bj) + K 


30 bits 


61ijK 


SBi 


Xj+K 


Set Bi to (Xj) + K 


30 bits 


62ijK 


SBi 


Xj 


Set Bi to (Xj) 


15 bits 


63ij0 


SBi 


Xj+Bk 


Set Bi to (Xj) + (Bk) 


15 bits 


63ijk 


SBi 


Bk+Xj 


Set Bi to (Xj) + (Bk) 


15 bits 


63ijk 


SBi 


Aj 


Set Bi to (Aj) 


15 bits 


64ij0 


SBi 


Aj+Bk 


Set Bi to (Aj) + (Bk) 


15 bits 


64ijk 


SBi 


Bk+Aj 


Set Bi to (Aj) ^ (Bk) 


15 bits 


64ijk 


SBi 


Aj-Bk 


Set Bi to (Aj) - (Bk) 


15 bits 


65ijk 


SBi 


-Bk+Aj 


Set Bi to (Aj) - (Bk) 


15 bits 


65ijk 


SBi 


Bj 


Set Bi to (Bj) 


15 bits 


66ij0 


SBi 


Bj+Bk 


Set Bi to (Bj) i (Bk) 


15 bits 


GCijk 


SBi 


-Bk 


Set Bi to (BO) - (Bk) 


15 bits 


67i0k 


SBi 


Bj-Bk 


Set Bi to (Bj) - (Bk) 


15 bits 


67ijk 


SBi 


-Bk+Bj 


Set Ai to (Bj) - (Bk) 


15 bits 


C7ijk 
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Examples : 

Code Generated 

6011777772 
6110777772 
6121000011 
6231000100 
63*»?7 

6<*'5«»0 
656M 
656«t? 
66711 
6^7^! 



LOCATION 



OPERATION 



II 



sni 

SB1 
SB? 
SB3 
SBU 
SB5 
SR5 

<;b6 

SR6 

SB7 
SB? 



VARIABLE 



IS 



Al-5 

-5 

3+B1+6 

xi+ioon 

X2 + 87 

A«f«-Bl 

-Bl + Al* 

01 + P1 
R5-ni 



COMMENTS 



130 



8.4.47 SET X REGISTER INSTRUCTIONS 

The SXi instructions perform one's complement addition and subtraction of 18-bit operands and store 
an 18-bit result into the lower 18 bits of operand register Xi. The sign of the result is extended to the 
upper 42 bits of operand register Xi. An overflow condition is ignored. 

Operands are obtained from address (A), index (B), and operand (X) registers as well as the instruction 
itself (K - 18-bit operand). Operands obtained from an Xj register are the truncated lower 18 bits of the 
60-bit word. The highest order bits are ignored. 



60279900D 
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Formats : 



6600 Functional 
7600 Functional 



Unit: Increment 
Unit: Increment 



Operation 


Variable 


Description 


Size 


Octal Code 


SXi 


Aj+K - 


Set Xi to (Aj) + K 


30 bits 


70ijK 


SXi 


K 


Set Xi to K 


30 bits 


71iOK 


SXi 


Bj+K 


Set Xi to (Bj) + K 


30 bits 


71i]K 


SXi 


Xj+K ,, 


Set Xi to (Xj) + K 


30 bits 


72ijK 


SXi 


x i 


Set Xi to (Xj) 


15 bits 


73ij0 


SXi 


Xj+Bk * 


Set Xi to (Xj) + (Bk) 


15 bits 


73ijk 


SXi 


Bk+Xj. 


Set Xi to (Xj) + (Bk) 


15 bits 


73ijk 


SXi 


Aj 


Set Xi to (Aj) 


15 bits 


74ij0 


SXi 


Aj+Bk •*< 


Set Xi to (Aj) + (Bk) 


15 bits 


74ijk 


SXi 


Bk+Aj 


Set Xi to (Aj) + (Bk) 


15 bits 


74ijk 


SXi 


Aj-Bk 


Set Xi to (Aj) - (Bk) 


15 bits 


75ijk 


SXi 


-Bk+Aj 


Set Xi to (Aj) - (Bk) 


15 bits 


75ijk 


SXi 


Bj 


Set Xi to (Bj) 


15 bits 


76ij0 


SXi 


Bj+Bkxy 


Set Xi to (Bj) + (Bk) 


15 bits 


76ijk 


SXi 


-Bk 


Set Xi to (BO) - (Bk) 


15 bits 


77i0k 


SXi 


Bj-Bk- 


Set Xi to (Bj) - (Bk) 


15 bits 


77ijk 


SXi 


-Bk+Bj 


Set Xi to (Bj) - (Bk) 


15 bits 


77ijk 



Examples: 

Code Generated 

7000005233 + 

7110775755 

7121000005 

72377777^ 

73«*«»2 

7^553 

756<*1 
7560«* 
76776 
77751 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




11 


18 


30 






sxo 


BNEG+A3+1 








SXI 


-2022R 








SX2 


Rl + 5 








SX3 


X3-33B 








SX^ 


X^ + R2 








SX5 


H5+ C1 3 








SX5 


&k 








SX6 


-Bl + A«* 








SX6 


A0-B1* 








SX7 


B7 + B6 








SX7 


B5-B1 
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PPU SYMBOLIC MACHINE INSTRUCTIONS 



The 6000/7000 COMPASS assembler recognizes symbolic notation for peripheral processor unit 
instructions. The assembler identifies each symbolic instruction by name and generates a one word 
(12 bit) or two word (24 bit) object code machine instruction under control of the current origin, 
location, and position counters. All PPU code is absolute. Numeric data must be in integer notation. 
Floating point notation is illegal. 

9.1 MACHINE INSTRUCTION FORMATS 

An assembled instruction has a 12-bit or 24-bit format. The 12-bit format has a 6-bit operation code f 
and a 6-bit operand d. A PPU accomplishes program indexing and manipulates operands in several 
modes. The 12-bit and 24-bit instruction formats provide for 6-bit, 12-bit, or 18-bit operands and 
6-bit or 12-bit addresses. Figures 9-1 and 9-2 illustrate the 12-bit instruction format and the 24-bit 
instruction format, respectively. 

Direct Mode: 

d = memory address of operand 

operation Indirect Mode: 

code 

d = memory address of the address 
of the operand 



(P) 



11 06 05 00 No Address Mode: 



d = 6-bit operand, shift count, or 
relative address 

Other: 

d = special value; e. g. , channel designator 

Figure 9-1. PPU 12-bit Instruction Format 



60279900A 9-1 



The 24-bit format uses the 12-bit quantity m, which is the contents of the next program address (P + 1), 
with d or the contents of d to form an 18-bit operand or a 12-bit operand address. 



Indexed Mode: 



operation 
code 



(P) 



(P+l) 
11 





t 


^ 










f 


d 


11 




06 05 




00 


L) 


m 



00 



d = address of the index for 
modifying the address of 
the operand 

m = base address of the operand 
(d) + m = address of operand 

Constant Mode: 

dm = 18-bit operand 

Other: 



dm = special values; e. g. , d = channel 
designator and m = 12-bit address 
of word count on IAM and OAM 
instructions 



Figure 9-2. PPU 24-bit Instruction Format 



9.2 SYMBOLIC NOTATION 

This section describes notation used for coding symbolic PPU machine instructions. Instructions are 
described in octal operation code sequence which generally reflects the mode of addressing. 
Instructions unique to either the 7600 or 6000-series computer systems are identified as such. 

The location field of a symbolic PPU machine instruction optionally contains a location symbol. When 
the symbol is present, it is assigned the value of the location counter. 

The operation field of a symbolic PPU machine instruction contains a three- character name. 

The variable field contains one or two subfields. Each subfield contains an absolute or relocatable 
expression that reduces to a 6-bit, 12-bit, or 18-bit value. 

Designators used in this section are listed in Table 9-1. 



9-2 
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TABLE 9-1. PERIPHERAL PROCESSOR INSTRUCTION DESIGNATORS 



Use 



18-bit A register 

An expression that reduces to an 18-bit operand value. 

A 6-bit operand or operand address expression. 

A 12-bit expression value used with d or (d) to form an 18-bit operand or 12-bit 
operand address. 

12-bit Program Address register 

12-bit Q register 

An expression that reduces to a 6-bit value (-37„ <r< 37 8 ) 
specifying relative address or shift count 

Contents of a register or location 
Refers to indirect addressing 



tructions provide similar functions using different modes of addressing. They can be 
ing to function as shown below: 

Description 



nission 



The following instructions either load data into the A register or store 
data from it. A load instruction loads a 6-bit, 12-bit, or 18-bit value 
as indicated by the instruction; any remaining upper bits of A are zeroed 
except for the LCN instruction for which the upper 6 bits are set to one. 

A store instruction stores the lower 12 bits of the A register contents into 
a memory location indicated by the instruction. 

The contents of A are not altered. 

Instruction Octal Code Section 



LDN 


14 


9.2.3 


LCN 


15 


9.2.3 


LDC 


20 


9.2.4 


LDD 


30 


9.2.9 


STD 


34 


9. 2. 9 


LDI 


40 


9.2.10 


STI 


44 


9.2.10 


LDM 


50 


9.2.11 


STAI 


54 


9.2.11 
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Function (cont'd) Description (cont'd) 

Arithmetic A PPU arithmetic instruction adds or subtracts a 6-bit, 12-bit, or 

18-bit quantity from the contents of the A register and enters the result 
in A. 



Instruction 


Octal Code 


Section 


ADN 


16 


9.2.3 


SBN 


17 


9.2.3 


ADC 


21 


9.2.4 


ADD 


31 


9.2.6 


SBD 


32 


9.2.6 


ADI 


41 


9.2.7 


SBI 


42 


9.2.7 


ADM 


51 


9.2.8 


SBM 


52 


9.2.8 



Logical A logical instruction forms a logical value in A using the contents of A 

as one of the operands and a 6-bit, 12-bit, or 18-bit value indicated by 
the instruction as the second operand. When the second operand is 
fewer than 18 bits, the remaining upper bits of A are unaltered for all 
but the LPN instruction for which the upper 12 bits are zero. 

Formation of a logical difference is equivalent to setting each bit in A 
that is unlike the corresponding bit in the second operand. For example, 

Initial (A) 0101 

Operand 1100 

Final (A) 1001 

Formation of a logical product is equivalent to setting a bit in A when 
the original setting of the bit in A and the corresponding bit in the second 
operand are both one's. 

For example, 

Initial (A) 0101 

Operand 1100 

Final (A) 0100 

A selective clear sets a bit zero in the A register wherever a bit is set 
in the second operand. For example, 

Initial (A) 0101 

Operand 1100 

Final (A) 0001 
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Function (cont'd ) Description (cont'd) 

Logical (cont'd) Logical instructions include the following: 

Instruction Octal Code Section 



LMN 


11 


9.2.3 


LPN 


12 


9.2.3 


SCN 


13 


9.2.3 


LPC 


22 


9.2.4 


LMC 


23 


9.2.4 


LMD 


33 


9.2.9 


LMI 


43 


9.2.10 


LMM 


53 


9.2.11 



Replace A replace instruction performs an arithmetic operation and returns the 

results to the A register and the memory location from which one operand 
was obtained. The lower 12 bits of the result replaces the operand 
obtained from a memory location. 



Instruction 


Octal Code 
35 


Section 


RAD 


9.2.9 


AOD 


36 


9.2.9 


SOD 


37 


9.2.9 


RAI 


45 


9.2.10 


AOI 


46 


9.2.10 


SOI 


47 


9.2.10 


RAM 


55 


9.2.11 


AOM 


56 


9.2.11 


SOM 


57 


9.2.11 



9.2.1 BRANCH INSTRUCTIONS 

For branch instructions, the r subfield is a numeric value that indicates the number of locations to be 
jumped (maximum 31). When r is positive (01-37g), the jump is forward r locations. When r is 
negative (76 g -40 8 ), the jump is backward 77 g -r locations. In the following tests, negative zero 
(777777) is nonzero. For conditional instructions, when the test condition is true, the jump takes place. 
When the condition is not met, execution continues with the next instruction. 

CAUTION 

The jump count must not be 00 or 77. If it is, execution 
loops on the jump instruction. 

The J option of the PPU instruction (section 4. 3. 2) and the PERIPH instruction (section 4. 3. 3) cause 
the value of the location counter to be subtracted from the value of the symbolic address (tag) before it 
is placed in the d field of the object code instruction. 
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Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


LJM 


m,d 


Long jump to m+(d); if d = 0, m is not 










modified 


24 bits 


01dm 


RJM 


m,d 


Return jump to m+(d); Store P+2 at m+(d) 










and jump to m+(d)+l. 


24 bits 


02dm 


UJN 


rt 


Unconditional jump to P+ r locations 


12 bits 


03d 


UJN 


tag 


Unconditional jump to tag 


12 bits 


03d 


ZJN 


rt 


Zero jump; jump to P+r locations if 










(A) = 


12 bits 


04d 


ZJN 


tag 


Zero jump to tag 


12 bits 


04d 


NJN 


rt 


Nonzero jump; jump to P+r locations if 










(A) t^O 


12 bits 


05d 


NJN 


tag 


Nonzero jump to tag 


12 bits 


05d 


PJN 


rt 


Positive jump; jump to P+r locations if 










(A)>0 


12 bits 


06d 


PJN 


tag 


Positive jump to tag 


12 bits 


06d 


MJN 


rt 


Minus jump; jump to P+r locations if 










(A)<0 


12 bits 


07d 


MJN 


tag 


Minus jump to tag 


12 bits 


07d 



tlf PPU or PERIPH J option has been selected, r is not valid. The contents of the variable field must 
be a symbolic address (tag). 

Examples : 

Code Generated 

0100 1362 

0271 0000 

0371 

0U04 

0525 

0667 

0726 

In the above examples, the LJM instruction is at address 0014 8 . TAG1 is address 0012 s , TAG2 has a 
value of 13 8 , TAG3 has a value of 25 g , and TAG4 has a value of 26 . 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


30 






LJM 


START 


| 






RJM 


0,CTO 








UJN 


TAG1-* 








ZJN 


+<♦ 








NJN 


TflG3 








PJN 


TAG?-* 








MJN 


TAGU 
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Code Generated 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 [30 






PPU 

UJN 
ZJN 
NJN 
PJN 
MJIM 


J ' 

TAG1 | 

TAG 3 ' In ^ s exam Ple> the UJN is at 
1 address 0040. TAG1 is address 

TAG2+10 1 0010, TAG2 is 0011, TAG3 is 
| address 0045, and TAG4 is 

-1+TAG«» | address 0046. 

TAG! 1 



03«+7 

0556 
060? 
07t.? 

9.2.2 SHIFT INSTRUCTION 

The SHN instruction shifts the contents of the A register right or left r places. If r is positive (+1 to 
+31), the shift is left circular r places; if r is negative (-31 to -1), the shift is end off r places to the 
right with no sign extension. No shift takes place when r is + 0. The assembler places the value of 
the r expression in the d field. If -31 >r >31 , the assembler generates an address error. 

Format: 



Operation 



SHN 



Variable 



Description 



Shift (A) by + (left) or - (right) r bits 



Size 



12 bits 



Octal Code 



lOd 



Examples: 

1. Shift contents of A left circular 6 places 
Code Generated 



LOCATION 



OPERATION 



1006 ^HN 

Shift contents of A right end off 6 places 
Code Generated 

6 
1071 



VARIABLE 



130 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 




S^NT 


STT 
SHN 


6 f 
-SCNT j 



60279900B 



9-7 



9.2.3 NO ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, the contents of the d field are interpreted as a 6-bit 
positive operand. This mode eliminates the need for storing many constants in core. 

Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


LMN 


d 


Logical difference (A)-d — A 


12 bits 


lid 


LPN 


d 


Logical product (A) *d —A 


12 bits 


12d 


SCN 


d 


Selective clear (A) 


12 bits 


13d 


LDN 


d 


Load d— A 


12 bits 


14d 


LCN 


d 


Load complement d— A 


12 bits 


15d 


ADN 


d 


Add (A)+d— A 


12 bits 


16d 


SBN 


d 


Subtract (A)-d— A 


12 bits 


17d 



Examples: 

Code Generated 

1112 
1?07 

1>15 

151*4 

lf.Pl 
17n? 



\* 





LOCATION 


OPEKATION 


VARIABLE 


COMMENTS 




1 




II 


18 


30 








LMN 


t2^ 










L D N 


7 










SCN 


?1" 








flfl 


S r T 

LIN 

LCN 
AON 
<:nN 


na 

a a - 1 
I 
•> 
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9.2.4 CONSTANT MODE INSTRUCTIONS 

In this mode, during instruction execution, the contents of the d and m fields are taken directly as an 
operand. This mode also eliminates the need for storing many constants. The assembler reduces 
absolute or relocatable expression c to an 18-bit value and stores the upper six bits in d and the lower 
12 bits in m. 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


LDC 


c 


Load c -*A 


24 bits 


20dm 


ADC 


c 


Add (A)+c —A 


24 bits 


21dm 


LPC 


c 


Logical product (A) *c —A 


24 bits 


22dm 


LMC 


c 


Logical difference (A)-c -►A 


24 bits 


23dm 



Examples: 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 130 








1 




MM 
MASK 


LOC 

ADC 

LPC 

SET 
LMC 


707070B i 

1 

j 

VfiL-1 | 

070707B 1 

070707B I 
MASK } 



Code Generated 

2070 7070 


2177 7776 

2?07 0707 

70707 

2307 0707 

9.2.5 NO OPERATION INSTRUCTION 

The PSN instruction specifies that no operation is to be performed. It provides a means of padding 
a program. 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


PSN 




No operation (Pass) 


12 bits 


2400 



Example : 

Code Generated 

2<tfl0 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 








1 






PSN 


1 
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Other octal operation codes (not generated by COMPASS) that act as pass instructions are: 



6000 Series 

00 
25 



7600 

25 
26 
27 
75 
76 



9.2.6 EXCHANGE JUMP INSTRUCTIONS (6000-SERIES ONLY) 

The EXN instruction transmits an 18-bit (absolute) address of which only 17 bits are used from the A 
register to the CPU with a signal notifying the CPU to execute an exchange jump. The address in A is 
the starting location of the 16-word exchange package which contains information about the CPU program 
to be executed. The 18-bit initial address must be entered in A before the EXN instruction is executed. 
The CPU replaces the file with similar information from the interrupted CPU program. The PPU is not 
interrupted. 

The MXN instruction conditionally exchange jumps to the CPU and initiates CPU monitor activity. If the 
monitor flag bit is clear, this instruction sets the flag and initiates the exchange. If the monitor flag 
bit is set, this instruction acts as a pass instruction. The starting address for this exchange is the 
18-bit address in the PPU A register. This address must be entered in A before the MXN instruction 
is executed. 



In 6500 systems with dual central processors, d can be or 1 and specifies which CPU the exchange 
jump will interrupt. In 6300, 6400 and 6600 systems, this value is not interpreted. 

Formats : 



Operation 


Variable 


Description 


Size 


Octal Code 


EXN 
MXN 


d 
d 


Exchange jump to CPU d 
Monitor exchange jump CPU d 


12 bits 
12 bits 


260d 
261d 



Examples: 

Code Generated 

2601 
2610 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 |30 














EXN 
PXN 


i ! 

/ ■ 
I 



9-10 



60279900A 



9.2.7 READ PROGRAM ADDRESS INSTRUCTION (6000-SERIES ONLY) 

This instruction transfers the contents of the CPU P register to the PPU A register; this allows the 
PPU to determine whether the CPU is in execution. In a 6500 system with dual central processors, 
the lowest order bit of the instruction format specifies which CPU P register is to be examined. In 
G400 and 6000 systems, this bit is not interpreted. The largest value that (P) can be is 17 bits. An 
ECS transfer is in progress when bit 17 of this instruction is set. However, bit 17 of P is not set. 



Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


RPN 


d 


Read program address CPU d— A 


12 bits 


27 Od 



Example: 

Code Generated 

2700 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


is ho 






RPN 


1 — — — 

1 
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9.2.8 6416 PPU INSTRUCTIONS 

COMPASS assembles the following iastructions for execution on a 6416 computer system only. The 
ETN instruction initiates memory transfer operations by transmitting an 18-bit address from the 
PPU A register to the 6416 16K memory. This address points to a word having the following format: 



xo 


AO 


K 


59 36 


v v 

Starting Address 
in 16 K Memory 


18 






00 


V 

Starting Address 
m Extended Core Storage 




Word Count 





Expression d of this instruction specifies the transfer to be performed: 

If d is 0, K words are transferred from ECS to 16K memory. 
If d is 1, K words are transferred from 16K memory to ECS. 

Note that addresses contained in the word are absolute addresses. Operating systems may require 
relocation (adding RA to an address) and field length testing, e. g. , Is address + RA FL? The 
Exchange Jump package contains RA and FL values for central memory and for extended core storage. 
The 6416 has no hardware for automatic relocation and field length testing; it is therefore incumbent 
upon the program to perform these functions whenever required by an operating system. 

The ERN instruction examines the status of the data trunk between 16K memory and the extended core 
coupler. If the data trunk is busy (a transfer is in progress), a 1 is placed in the most significant bit 
position of the A register. If the trunk is free (not busy), the A register remains cleared. The d 
portion of this instruction is ignored. 

After execution of this instruction the program would typically test the A register for a sign before 
executing an instruction that initiates an ECS operation. 

Formats : 



Operation 


Variable 


Description 


Size 


Octal Code 


ETN 
ERN 


d 
d 


Extended core transfer 

Read extended core coupler status 


12 bits 
12 bits 


260d 
27 Od 



Examples: 

Code Generated 

2600 
2700 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 








I 






ETN 
ERN 


1 
1 
1 

1 
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9.2.9 DIRECT ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, the contents of the d field specify the address of the operand. 
During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that 
specifies one of the first 100§ addresses in core memory (0000 - 0077 8 ). During execution of LDD, 
ADD, and SBD, (d) is treated as a 12-bit positive quantity. 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


LDD 


d 


Load (d)— A 


12 bits 


30d 


ADD 


d 


Add (A) + (d)— A 


12 bits 


31d 


SBD 


d 


Subtract (A) -(d)— A 


12 bits 


32d 


LMD 


d 


Logical difference (d) and (A)--* A 


12 bits 


33d 


STD 


d 


Store (A)— d 


12 bits 


34d 


RAD 


d 


Replace add (d) + (A)-*-d and A 


12 bits 


35d 


AOD 


d 


Replace add (d) + 1— d and A 


12 bits 


36d 


SOD 


d 


Replace subtract one (d) - 1— d and A 


12 bits 


37d 



Examples : 



Code Generated 

301? 
3103 
3?^0 
33?7 
"^01 
35*5 
3612 
3713 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


30 






LOO 


TAG1 








ADD 


TAG?-10B 








SBD 


«*0B 








LMD 


TAG1+15B 








STO 


1 








RAD 


55F} 








flOO 


TAG1 








SOD 


TAG? 
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9.2.10 INDIRECT ADDRESS MODE INSTRUCTIONS 



In this mode, during instruction execution, d specifies an address, the contents of which specify the 
address of the desired operand. Thus, d specifies the operand address indirectly. 

During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit value that 
specifies one of the first 100 g addresses in core memory (0000 - 0077 g ). 

On the 7600, the address formed permits referencing of all memory locations but one (0000 - 7776 g ). 

On a 6000-Series Computer System PPU, the address formed in indirect address mode permits 
referencing of all memory locations, including address 7777 g . 

Formats : 



Operation 



LDI 

ADI 

SBI 

LMI 

STI 

RAI 

AOI 

SOI 



Variable 



d 
d 
d 
d 
d 
d 
d 
d 



Description 



Examples: 



Code Generated 
<»012 

k2U0 
<*3?7 

«»<»m 

U612 
(♦713 



Load ((d)) —A 

Add (A) + ((d))— A 

Subtract (A) - ((d)) —A 

Logical difference (A) - ((d))— A 

Store (A) —(d) 

Replace add ((d)) + (A) — (d) and A 

Replace add one ((d)) + 1 — (d) and A 

Replace subtract one ((d)) - 1 — (d) and A 



Size 



12 bits 


40d 


12 bits 


41d 


12 bits 


42d 


12 bits 


43d 


12 bits 


44d 


12 bits 


45d 


12 bits 


46d 


12 bits 


47d 



Octal Code 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


30 






LDI 


TAG1 


1 






ADI 


TAG2-1Q 








SRI 


«*0P 








LMI 


TAGl+lSP 








STI 


1 








RAI 


55R 








AOI 


TAG1 








SOI 


TAG2 
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9.2.11 INDEXED DIRECT ADDRESS MODE INSTRUCTIONS 

In this mode, during instruction execution, the value formed by m+(d) is used as the address of the 
operand. During assembly, the assembler reduces absolute or relocatable expression d to a 6-bit 
value that specifies one of the first 100 g addresses in core memory (0000 - 0077s). Tne value of 
absolute or relocatable expression m is a 12-bit base address. 

NOTE 

The address formed in indexed addressing permits 
referencing of all memory locations but one 
(0000-776 8 ). Although m and/or (d) can have a 
value of 77773, tne com P u ter system does not 
permit m+(d) to reference address 7777g. 



When in indexed direct address mode, if d is nonzero the contents of address d are added to m to 
produce a 12-bit operand address (indexed addressing). If d is zero, m is taken as the operand address. 



Formats : 



Operation 


Variable 


Description 


Size 


Octal Code 


LDM 


m,d 


Load (m+(d))— A 


24 bits 


50dm 


ADM 


m,d 


Add (m+(d))— A 


24 bits 


51dm 


S'BM 


m,d 


Subtract (m+(d))— A 


24 bits 


52dm 


LMM 


m,d 


Logical difference (A) - (m+(d))— A 


24 bits 


53dm 


STM 


m,d 


Store (A)— m+(d) 


24 bits 


54dm 


RAM 


m,d 


Replace add (m+(d)) + (A)-»m+(d) and A 


24 bits 


55dm 


AOM 


m,d 


Replace add one (m+(d)) + 1— m+(d) and A 


24 bits 


56dm 


SOM 


m,d 


Replace subtract one (m+(d)) - 1— m+(d) 
and A 


24 bits 


57dm 



Examples: 

Code Generated 

5077 0203 

5106 0202 

5200 0202 
5315 7000 

5<*10 0272 

5500 03«»2 

5600 0173 

5712 0203 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 ho 






LDM 


1 

TAG6,77B I 






ADM 


TAG5,fa [ 






SBM 


TAG5 ] 






LMM 


7000B, 15B 1 






STM 


TAG5+70B,TAGl-2 






RAM 


1 
1^0B+TAG5,0 






AOM 


-10B+TAG6 1 






SOM 


TAG6fTAGl ' 

1 
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9.2.12 CENTRAL READ/WRITE INSTRUCTIONS (6000-SERIES ONLY) 

The CRD instruction transfers a 60-bit word from central memory to five consecutive PPU locations. 
The 18-bit address of the central memory location must be loaded into A prior to executing this 
instruction. (Note that this is an absolute address. ) The 60-bit word is disassembled into five 12-bit 
words beginning at the left. Location d receives the first 12-bit word. The remaining 12-bit words 
go to successive locations. The (A) are not altered. 

The CRM instruction reads a block of 60-bit words from central memory. The content of location d 
gives the block length. The 18-bit address of the first central word must be loaded into A prior to 
executing this instruction. (Note that this is an absolute address. ) During the execution of the instruc- 
tion, (P) goes to processor address and P holds m. Also, (d) goes to the Q register where it is 
reduced by one as each central word is processed. The original content of P is restored at the end of 
the instruction. 

(A) is advanced by one to provide the next central memory address after each 60-bit word is 
disassembled and stored. The contents of the Q register are also reduced by one. The block transfer 
is complete when (Q)=0. The block of central memory locations proceeds from address (A) to 
address (A) + (d) -1. The block of processor memory locations proceeds from address m to m+5(d)-l. 

Each central word is disassembled into five 12-bit words beginning with the high-order 12 bits. The 
first word is stored at processor memory location m. The content of P (which is holding m) is 
advanced by one to provide the next address in the processor memory as each 12-bit word is stored. 
If P overflows, operation continues as P is advanced from 7777 g to 0000 g . These locations will be 
written into as if they were consecutive. 

The CWD instruction assembles five successive 12-bit words into a 60-bit word and stores the word 
in central memory. The 18-bit address word designating the central memory location must be in A 
prior to execution of the instruction. (Note that this is an absolute address.) 

Location d holds the first word to be read out of the processor memory. This word appears as the 
higher order 12 bits of the 60-bit word to be stored in central memory. The remaining words are taken 
from successive addresses. 

The CWM instruction assembles a block of 60-bit words and writes them in central memory. The content 
of location d gives the number of 60-bit words. The content of the A register gives the beginning 
central memory address. (Note that this is an absolute address.) During the execution of this instruction 
(P) goes to processor address 0, and P holds m. Also, (d) goes to the Q register, where it is reduced 
by one as each central word is assembled. The original content of P is restored at the end of the 
instruction. 

The content of P (the m portion of the instruction) gives the address of the first word to be read out of 
the processor memory. This word appears as the higher order 12 bits of the first 60-bit word to be 
stored in central memory. 

The content of P is advanced by one to provide the next address in the processor memory as each 
12-bit word is read. If P overflows, operation continues as P is advanced from 7777„ to 0000 g . 
These locations will be read from as if they were consecutive. 

(A) is advanced by one to provide the next central memory address after each 60-bit word is assembled. 
Also, Q is reduced by one. The block transfer is complete when (Q)=0. 
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Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


CRD 


d 


Central read from (A) to d 


12 bits 


60d 


CRM 


m,d+ 


Central read from (d) CM words begin- 










ning at CM (A)— PPU m 


24 bits 


61dm 


CWD 


d 


Central write from d to (A) 


12 bits 


62d 


CWM 


m,d+ 


Central write (d) words beginning at 










PPU m— CM (A) 


24 bits 


63dm 



f Expression d is required 

Examples: 

Code Generated 
6015 

6125 0012 

6232 

6350 0012 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


is ho 






CRD 

CRM 
CWD 

CWM 


156 [ 

TAG1.259 ! 
328 i 
TAG1.50B | 



9.2.13 I/O BRANCH INSTRUCTIONS (6000-ONLY) 

The following instructions are conditional long jump instructions, each of which tests for a condition 
on channel d. When the condition is true, the jump to address m takes place. When the condition is 
not met, execution continues with the next instruction. These instructions are exclusively 6000-series 
PPU instructions. The d expression is required. 

For the FJM instruction, an input channel is full when the input equipment has sent a word to the channel 
register and sets the full flag. The channel remains full until the PPU accepts the word and clears the 
flag. An output channel remains full when a PPU sends a word to the channel register and sets the 
full flag. The channel is empty when the output equipment accepts the word and notifies the PPU. 

Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


AJM 


m,d 


Jump to m if channel d active 


24 bits 


64dm 


IJM 


m,d 


Jump to m if channel d inactive 


24 bits 


65dm 


FJM 


m, d 


Jump to m if channel d full 


24 bits 


66dm 


EJM 


m,d 


Jump to m if channel d empty 


24 bits 


67dm 
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Examples : 

Code Generated 

6i«02 0012 
6502 0013 
660** 0025 
670«» 0026 





LOCATION 


OPERATION 


VARIABLE 


COMMENTS 


1 




II 


18 


30 






AjM 


TAG1.2 








IJM 


TAG2,CHAN-2 








FJM 


TAG3,*f 








EJM 


TAG<»,CHAN 





9.2.14 I/O BRANCH INSTRUCTIONS (7600 ONLY) 

The following instructions are conditional long jump instructions each of which tests a condition on 
channel d. When the condition is true, the jump to address m takes place. When the condition is not 
met, execution continues with the next instruction. These instructions are exclusively 7600 PPU 
instructions. The d expression is required. 

Formats : 



Operation 



FIM 
EIM 
IRM 
NIM 

FOM 
EOM 

ORM 
NOM 



Variable 



m,d 
m,d 
m,d 
m,d 

m,d 
m,d 

m,d 
m,d 



Description 



Size 



Jump to m on channel d input word flag 24 bits 

Jump to m if no input word flag on channel d 24 bits 

Jump to m on channel d input record flag 24 bits 

Jump to m if no input record flag on 

channel d 24 bits 

Jump to m on channel d output word flag 24 bits 

Jump to m if no output word flag on 

channel d 24 bits 

Jump to m on channel d output record flag 24 bits 

Jump to m if no output record flag on 

channel d 24 bits 



Octal Code 



60dm 
61dm 
62dm 

63dm 
64dm 

65dm 
66dm 

67 dm 
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Examples: 



Code Generated 

6005 1365 

6102 1365 

6201 1366 

630<* 1366 

6<*15 7000 

6^00 1525 

6601 1266 

67fl5 1366 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 1 30 






FIM 


TAG5,5 J 






FIM 


TAG5,2 | 






IRM 


TAG6,1 | 




CHAN 


SFT 


k | 






NIM 


TAG6,THAN 






FOM 


7000P,15R 1 






EOM 


Itt00+TAG5, [ 






ORM 


-100R+TAG6,fHAN-3 






NOM 


TAG6,GHAN+1 j 
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9.2.15 A REGISTER INPUT/OUTPUT INSTRUCTIONS 

The following instructions transfer a word to or from channel d and the lower 12 bits of the A register. 

On the 7600, the IAN instruction is not executed until the input channel d word flag is set. If the flag 
is not set when the instruction is read, execution halts until an external signal sets the flag. The 
input channel d record flag does not affect the IAN execution. The IAN instruction clears the input 
channel d word flag and record flag and transmits a resume signal over the input cable after the 
word is entered in the A register. 

On the 7600, the OAN instruction is not executed while the output channel d word flag is set. If the 
flag is set, execution stops until an external resume signal clears the flag. This instruction sets 
the output channel d word flag and transmits a work pulse over the output channel d cable. 

On a 6000-series machine, executing either of these instructions when the channel is inactive 
causes the peripheral processor unit to become inoperative until some other peripheral processor 
activates the channel, or the system is deadstarted 

Formats : 



Operation 


Variable 


Description 


Size 


Octal Code 


IAN 
OAN 


d 
d 


Input : channel d to A 
Output: (A) to channel d 


12 bits 
12 bits 


70d 
72d 



Examples: 

Code G enerated 

7003 
720i» 



LOCATION 



OPERATION 



II 



IAN 

OAN 



VARIABLE 



COMMENTS 



3 
CHAN 



9.2.16 BLOCK INPUT/OUTPUT INSTRUCTIONS 

The following instructions tranter a block of 12-bit words on channel d to or from a starting PPU 
memory location specified by m. The number of words transferred is specified by the contents of the 
A register which is reduced by one as each word is transferred. The operation is completed when (A) 
= or the channel becomes inactive (6000 only). 

On a 6000-series machine, the input operation is complete when (A) = or the data channel becomes 
inactive. If the operation is terminated by the channel becoming inactive, the next location in the 
processor memory is set to all 0's. The word count is not affected by this empty word. There- 
fore, the contents of the A register gives the block length minus the number of real data words 
actually read in. 

During execution of either of these instructions, address 0000 temporarily holds P, while the P register 
holds m. The contents of P advances by one to give the address for the next word as each word is 
transferred. 
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NOTE 

If this instruction is executed on a 6000-series machine 
when the data channel is inactive, no operation is accom- 
plished and the program continues at P + 2. However, 
the location specified by m is set to all zeros for the IAM 
instruction. 

On a 7600, the IAM instruction is not executed until the input channel d word flag is set. If the flag is 
not set when the instruction is read, execution halts until an external signal sets the flag. The 
presence of an input channel d record flag is ignored for the first word of the block but terminates the 
block input at any word after the first. In this case, the next location in the PPU block input storage 
area contains a noise word; any remaining locations are unaltered. Note that the storage location can 
be incremented through location 7776 to 0000 on a 7600, or location 7777 through 0000 on a 6000- 
series machine which could destroy existing data or a program. 

On a 7600, the OAM instruction is not executed until the output channel d word flag is cleared. If the 
flag is set when the instruction is read, execution halts until a resume pulse clears the flag. An out- 
put channel d record flag does not affect OAM execution. 

Formats : 



Operation 


Variable 


Description 


Size 


Octal Code 


IAM 
OAM 


m,d 
m,d^ 


Input: (A) words to m from channel d 
Output: (A) words fromm to channel d 


24 bits 
24 bits 


71dm 
73dm 



tExpression d is required 



Examples : 

Code Generated 

7103 l^bU 
73P<» U6I4 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


IB |30 








1 






TflM 

OAM 


tag,-* ; 

TAG,U | 
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9.2.17 SET OUTPUT RECORD FLAG INSTRUCTION (7600 ONLY) 

The RFN instruction sets the output channel d record flag and transmits a record pulse over the cable. 
The instruction ignores the previous status of the channel d flags; the instruction is executed even if the 
output channel d record flag is set. 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


RFN 


d 


Set output record flag on channel d 


12 bits 


74d 



Example: 

Code Generated 

71.11 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 |30 








i 






RFN 


IIP j 



9.2.18 CHANNEL FUNCTION INSTRUCTIONS (6000-SERIES ONLY) 

The ACN instruction activates the channel specified by d. This instruction must precede the IAN, 
IAM, OAM, or OAN instructions. Activating a channel alerts the input/output equipment for the 
exchange of data. Activating an already active channel causes the PPU to become inoperative until 
I another PPU or an external equipment deactivates the channel, or the system is deadstarted. 

The DCN instruction deactivates the channel specified by expression d. It stops the input/output 
equipment and terminates the buffer. Deactivating an already inactive channel causes the PPU to 
become inoperative until deadstart or until the channel is activated. Avoid disconnecting the channel 
before first sensing for channel empty, deactivating a channel before stopping the associated processor, 
or deactivating a channel before placing a useful program into the associated processor. After dead- 
start, PPUs wait on an input channel. Deactivating a channel after deadstart causes an exit to address 
0001 and execution of the program. 

The FAN instruction sends the external function code from the lower 12 bits of the A register on 
■ channel d. 

The FNC instruction sends the external function code specified by m on channel d. For this instruc- 
tion, expression d is required. 

I Execution of a FAN or FNC instruction when the channel is active causes the PPU to become 
inoperative until another PPU or an external equipment deactivates the channel, or the system 
is deadstarted. 

Formats: 



Operation 


Variable 


Description 


Size 


Octal Code 


ACN 


d 


Activate channel d 


12 bits 


74d 


DCN 


d 


Disconnect channel d 


12 bits 


75d 


FAN 


d 


Function (A) on channel d 


12 bits 


76d 


FNC 


c,d 


Function c on channel d 


24 bits 


77dm 
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Examples: 



7«.05 
750«. 
7605 
7705 0020 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




II 


18 |30 














ACN 
OCN 
FAN 
FNC 


5 

CHAN j 
CHAN+i ! 
206,5 ' 



9.2.19 ERROR STOP INSTRUCTION (7600 ONLY) 

The ESN instruction halts execution of the 7600 peripheral processor program and indicates a program 
error condition to the monitor control unit. The PPU must be restarted by a deadstart sequence from 
the MCU, only. This instruction is exclusively a 7600 PPU instruction. 

Format: 



Operation 


Variable 


Description 


Size 


Octal Code 


ESN 


d 


Error Stop 


12 bits 


7700 



Example : 

Code Generated 

7700 





LOCATION 


OPERATION 


VARIABLE COMMENTS 


1 




11 


18 1 30 








1 






FSN 


1 
1 
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PROGRAM EXECUTION 10 



COMPASS can be called from the library and placed in execution through a COMPASS call card or 
through an IDENT card (section 4.2.1) in a FORTRAN source deck. When COMPASS is called through 
FORTRAN, parameters are ordinarily specified on the RUN or FTN card and are the same as for the 
FORTRAN program. 

10.1 CONTROL CARDS 

Normal assembly of COMPASS source programs under SCOPE and execution of CPU binary object 
decks requires generation of a SCOPE job file. A file is usually submitted in the form of card decks 
or card images. The first record f of the file must contain the SCOPE control cards described in 
this section. Other optional cards are described in the operating system reference manual. Follow- 
ing the control card record are one or more records containing source statements and data. A control 
card key word, i. e. , name on the job card, begins in column one. A comma or a left parenthesis 
begins a parameter string. Parameters in the string are separated by commas. A period or right 
parenthesis terminates a parameter string. Comments optionally follow the terminator. 

10.1.1 JOB CARD 

A job card of the following format must be the first card in the deck. The parameters following name 
can be in any order or can be omitted. For any omitted field, SCOPE supplies a default value, which 
is an installation option. 

Control card format: 



(' 



name, Pp, Tt, CMscm, EClmc. 



name 1-7 character alphanumeric name by which the job is identified. 

The first character must be a letter. 

Pp Job priority 

SCOPE 1 

P4 Express job 

P3 Preferred job; the job will be placed in execution before a job of 

lower class. 

P2 or Normal job; the job will be placed inexecution before any deferred 

omitted job but after any priority job. 

PI Deferred job; may be assigned to a job that has a high proportion 

of CPU time to I/O time. 

Other The system uses an installation option. 



tSection for SCOPE 2. 
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SCOPE 2 and SCOPE 3. 3 

Pp p = priority level in octal. 1 £. p s. 2 , where k is an installation 

option less than or equal to 8. The lowest priority is 1. 

Tt CPU time limit in octal seconds (1-7777 ), must be sufficient to process all control 

cards for the job, including assembly and execution. 

CMscm Estimate of maximum amount of 7600 SCM or 6000 CM required for execution (1-6 

octal digits). The estimate for COMPASS is a minimum of 40000. The 7600 operating 
system rounds the value to the next higher multiple of 1000. The 6000 operating 
system round this value to the next higher multiple of 100. 

EClcm Estimate of maximum amount of 7600 LCM or 6000 ECS in octal thousands, required for 

assembly or execution (1 - 1400 8 ). The estimate for COMPASS is a minimum of none 
for SCOPE 1 and SCOPE 3. 3 and is 14 for SCOPE 2 (i. e. , 140008). 

COMPASS notes storage used on the listable output. For subsequent runs, the field lengths can be 
decreased accordingly. 

Examples: 

KlOBl, P2, T100, CM40000, EC30. 



(■■ 



TESTER. 



10.1.2 COMPASS CALL CARD 

The following control card causes the COMPASS assembler to be loaded from the SCOPE library and 
executed. Parameters specify modes and files. 

Control card format: 



f 



COMPASS(p lS p , ...,p ) 
12 n 



The optional parameters, p , may be in any order within the parentheses. A parameter can be omitted 
or can be in one of the following forms. 

mode 

mode = 

mode = filename 

Mode is one or two characters as described; and filename is a 1-7 character name of a file or a 
character string. 
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Mode 



Significance 



A - Abort mode 
A 
omitted 

B - Binary output 
omitted or B 
B=0 
B=filename 

D - Debug mode 
D 



omitted 



Abort job at end of run if any assembly errors occurred. 
Do not abort job for assembly errors. 

Binary on the load-and-go file (LGO) 
No binary output 
Binary on the named file 



Binary is generated on the file indicated by B parameter in spite of assembly errors 
and regardless of the abort mode (A parameter). 

D is ignored if B=0. 

Assembly errors inhibit binary output. In abort mode (A parameter present), no 
binary output is written at all for a subprogram containing assembly errors. Other- 
wise (A parameter omitted), the message ERRORS IN ASSEMBLY is written to the 
file indicated by the B parameter for each subprogram containing assembly errors. 

E - Extended binary table mode (SCOPE 2 only) 

omitted or Tables are generated as described in Loader Reference Manual, 

E=l Publication No. 60344200. 

E or E=0 Tables are generated non-extended as described in Appendix B. 

F - FORTRAN mode; establishes value of special element *F 



omitted or F *F is 

F=number *F is number (one decimal digit) 

F=name *F is a number corresponding to name as follows: 

COMPASS = 

RUN = 1 

FTN = 2 
G - Get text; takes precedence over S if both G and S options are selected. 
G Load systems text from file SYSTEXT f 

G=filename Load systems text from named file 

Load systems text from overlay named in S option 
I - Source of assembler input 

omitted Source deck is on INPUT file 

I Source deck is on COMPILE file in either compressed or expanded format. 

1=0 Illegal 

I=filename Source deck is on named file 



omitted or 
G=0 



JV2TEXT for SCOPE 2. 
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Mode 



Significance 



L - Full List 

omitted or L 
L=filename 



L=0 



List output on OUTPUT file 

List output on named file. When the full list is on a different file than the short 
list, the listing for each subprogram is preceded by a one-word header consisting 
of an asterisk and the first six characters of the subprogram name. This header 
identifies the subprogram as a convenience for sorting and cataloging. Also 
see O option. 

No full list will be generated 



LO-List options; selects or deselects a maximum of seven of the list options A, B, C, D, E, F, G, 
L, M, N, R, S, T, or X 

omitted or LOO Same as selecting B, L, N, and R only 

LO Selects list options C, F, G, and X, and deselects R 

, c A list of up to seven characters. Inclusion of B, L, N, or R deselects the corre- 



LO=c l C 2' 



n 



N 



sponding option. Otherwise, inclusion of a character selects the option. For 
options, refer to LIST pseudo instruction, section 4.11. 1. 

No eject; suppresses ejects caused by normal listing control. The only page ejects are at the 
beginning of new subprograms. 



N 
omitted 



No eject 
Normal ejects 



O - Short list; suppressed if full list is directed to the file or if no assembly errors occur. However, 
if the full list and short list are on different files (e. g. , the full list is written on OUTPUT and the 
short list is written on the named file), the short list will be augmented by the addition of any error 
lines originating with a macro call. 



omitted or O 

0=filename 

0=0 

Continue page 

P 

omitted 



List output on OUTPUT, file 

List output on named file 

No short list will be generated 



Page numbering continues from subprogram to subprogram. 

Page numbering begins with 1 for each END instruction. 
S - Source of SYSTEXT f information 

omitted or S Information is on SYSTEXT f overlay 

S=0 No source of SYSTEXT f information 

S=overlay Information is on named library overlay 



tV2TEXT for SCOPE 2. 
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X - Source of external text (XTEXT) when location field of XTEXT pseudo instruction is blank, 
omitted External text OLDPL filf 

X=filename External text on named file 

X=0 Illegal 

X External text on OPLfile f 

Examples: 



[COM PASS (B, D, S=OVI) 
|^OMPASS(LO=ASGXD) 



COMPASS. 

10.1.3 LGO CONTROL CARD 

An LGO control card calls for the loading and execution of CPU binary output produced by the assembler 
when the B option on the COMPASS card is selected. When binary output is on some file other than LGO, 
the card is replaced by a program call card for that file. SCOPE automatically repositions the LGO at 
load point before loading. The LGO file is temporary; it is released at job termination. 

Format: 







LGO. comments 



10.1.4 PROGRAM CALL CARD 

The program call card directs the operating system to search for a file or CPU program that has the 
name specified on the card, load it into the user's small core memory, and execute it as a CPU 
program. 

Formats : 






namefo ,p....,p ) 
1 £ n 



name. 

name Program name 

Pj Parameters in a format acceptable to the program being called. 

When the operating system locates the file, it repositions the file to load point, loads it, and, when 
loading is complete, executes the program as a CPU program. 



f MODIFY is not supported by SCOPE 2. 
60279900C 
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10.1.5 END-OF-RECORD CARD 

An end-of-record t card is characterized by having rows 7, 8, and 9 punched in column one. Columns 
2-80 optionally contain comments. The card separates records in the job deck. For example, a deck 
consisting of control cards, a source language deck for one or more subprograms, and a data deck, 
would include two end-of-record cards. The first terminates the control cards and the other terminates 
the source deck. A deck consisting of control cards only does not require an end-of-record card; an 
end- of- information card is used in its place. 



I 3 4 5 G r I 3 10 li 12 II K 15 lo II 13 r i 73 31 .:3 21 34 ". ::* 21 33 73 3:3 ' '7 : i M ^ 76 .if 33 13 43 '-' 4; :■ U 43 43 41 4« 33 SO Si 37 33 3* 33 56 5T 58 33 60 | 



1 61 6? 63 64 63 E-3 6' 65 63 70 11 7? 13 74 73 76 If TO 19 10 ] 

] ! 9 B 3 B o c a o II II B 8 B » 11 8 o a 

1 J J 4 S I 1 I 9 19 M 12 13 II IS II II II 19 70 II 77 11 H 13 76 71 2i 71 10 31 37 33 33 33 36 31 33 33 4] il 43 13 14 43 46 41 13 49 SO 51 57 53 34 55 56 51 53 59 CO 61 62 33 64 65 66 61 51 E9 10 II 12 T3 14 15 It II 1| 79 10 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ii i i i i i i i i i i ! i i i i i i i i i i i i i m i i t i i i i 1 1 1 i i i i i i i i 1 1 i n i i i i 1 1 1 

2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 

1 I ] 4 5 1 1 I 1 II II 17 13 II 15 IE 11 II 19 20 71 77 23 74 25 26 21 21 29 30 31 17 33 II 55 35 31 34 31 10 II 1? 43 14 45 46 47 43 40 53 51 52 53 34 55 56 51 39 59 60 61 6? 63 64 65 66 61 61 59 70 11 72 11 74 15 16 II II IS 90 

J 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3'3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 
4444444444444444444444444444 4444444444444444444444444444444444444444444444444444 

I 7 ] 4 5 I I I 9 10 II 12 13 14 15 IE 11 II 19 79 71 77 73 74 75 76 2! 21 29 39 31 32 33 34 35 35 3) 33 33 40 41 47 43 34 4, 4t, II 43 43 50 51 52 53 54 35 56 51 53 59 60 61 63 63 64 65 66 El 69 69 10 II 12 13 14 15 16 7' H 13 II 

S-5 5 5 S 5 5 5 5 5 5 5 5 S 5 5 5 5 S 5 5 5 5 5 5 5 5 s 5 5 S 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 
6 6 6 6 6 6 6 6 6 E B 6 6 E G B 6 B B B B B 6 6 B B B 6 B 6 B E 6 B 6 6 B E 6 B £ B 6 6 6 B 6 6 E 6 6 6 B 6 B 6 6 6 6 6 6 6 6 6 B 6 6 6 6 6 6 B 6 6 6 6 fi B 6 B 

I 2 3 4 5 E 1 I 9 II II 12 13 14 15 16 II II 13 20 71 22 73 34 25 26 33 21 29 31 31 37 33 34 35 36 31 31 39 40 41 47 43 44 45 46 41 48 49 50 51 52 53 54 55 56 51 59 59 60 61 62 63 64 65 65 61 56 69 19 II 12 13 74 15 16 11 15 19 II 

|7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 J 7 7 J 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 1 1 7 7 7 7 J 7 J 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 
|8888B88888S8SS888888B8S86B888888888886688888688B88688888888888888C8888888888888 

I 2 3 4 5 6 1 I 9 10 II 17 13 IMS 16 II 19 13 70 21 77 73 71 75 76 71 21 23 30 3! 32 33 34 35 36 37 31 39 40 41 42 43 44 45 45 47 49 49 50 51 52 51 54 55 56 51 58 51 66 61 52 63 64 63 66 61 66 59 10 II 12 1] II 15 76 11 '3 19 E0 

■999999999939S99999S999999999999999999999999999999990999999999999999999S99933999 



10.1.6 END-OF-INFORMATION CARD 

An end-of-information card is characterized by having rows 6, 7, 8, and 9 punched in column one. 
Its use signals the end of the job deck. Columns 2-80 optionally contain comments. 



15 '* " l fl '9 30 21 32 31 24 33 7:6 21 26 39 30 31 32 33 34 35 36 3 I 3fl"";j 40 41 4? 43 44 46 43 41 46 49 30 51 57 S3 54 53 56 37 31 59 lo"] 



61 62 63 64 65 65 61 



68 69 10 71 12 73 14 Ti 76 77 II ID |Q | 



00 D 08 9 9 8 B 9 8 8 9 8 8 8 B B 8 8 B B B 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 9 8 8 8 9 8 9 

1 2 3 * s ( J * s H 'I 12 13 M 15 16 17 19 19 70 21 22 73 24 35 26 2! 21 79 30 3! 3? 33 34 35 35 37 31 39 40 41 47 43 44 45 46 41 49 19 50 51 51 53 54 55 56 51 51 59 60 II 12 63 E4 65 66 El II II 71 II 17 73 14 15 11 11 II 19 « 

'11111111111111111111111111111111111111111111111111111111111111111111111111:1111 

2 8 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 .2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 

1 2 3 4 & 1> 7 B 3 ID TI 1? 13 M 155 IK II II 19 10 21 2? 23 24 25 26 21 79 79 30 3! 33 33 34 35 35 31 31 39 10 41 42 43 44 45 46J! 49 49 50 51 52 53 54 55 51 51 SI 59 II II 12 il 14 15 E6 67 II 1! II 11 12 11 14 15 ]| 11 1| 1| » 

3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 
4444444444444444444444444444 4444444444444444444444444444444444444444444444444444 

I 2 1 I S I 1 I 9 10 II II II H 15 II II 11 19 19 21 22 21 21 25 26 21 11 2! 10 31 32 13 II 15 36 31 II 19 10 II 42 41 14 45 II 41 It 19 50 51 52 5! 51 55 56 51 51 51 III II 12 6] II (5 II 61 II 19 II 71 17 71 14 75 II 71 II 71 H 

5 5 5 5 15 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 5 
|6666 EE BE6B BE B G 6 G66 G6 E 6G B 6SE 66 66 G 6SBBE66 S6B BSGG BE E 666 6G 666666666S66E 666666E66EGE 

' 2 3 * s * 7 * 9 IB " 11 H II 15 II II 19 19 20 21 22 23 71 25 21 21 21 29 10 II 12 33 34 35 36 31 31 39 40 41 47 43 44 15 46 17 41 49 50 51 5? 51 54 SS 51 57 51 51 II II 17 13 14 IS U II El El II II 13 13 H IS II 77 II 79 M 

17 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 17 7 7 7 7 7 7 7 7 7 7 7 7 7777777777777777777777 

18 8 8 8 8 8 8 8 8 8 8 8 8 8 3 8 8 8 8 8 8 3 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 8 6 8 8 8 8 8 8 8 8 18 1 

' ' ' ' s * > ' > " 'I » " H "' « " II H 21 II 22 21 14 75 25 71 71 7! 10 31 33 31 11 15 16 31 31 33 11 II 12 43 41 45 41 11 II II 50 51 12 51 51 55 55 51 51 59 il El 12 i] II IS K II II II II II 11 II H 15 II 11 II 1) ■ 

|999999 9 9 9 9 9 9 99999 3 9 9 9 9 999 99999 9 9 9 9 9 9 9 999 999999 9 9 9 9 9 S 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 9 



CDC/LKV 506-. 



fEnd of section for SCOPE 2. 
10-6 §02789OQ.€ 



10.2 SAMPLE DECKS 

The following job calls for assembly of the source program and execution of the binary object program 
produced by the assembly. COMPASS reads source statements from file INPUT, writes the listing on 
OUTPUT, and writes a binary object deck on file LGO. Control card LGO calls for execution of the 
binary object program, which obtains its data from file input. 



(end of information) 
/ 



Subprogram 
TEST 





/ 




r 






7 
8 
9 




(end of record) 






/ 


END TEST 





^ Data for 
r execution 



IDENT TEST 



Control 
Record 



(end of record) 



( 



( 



LGO. 



COMPASS. 



SAMPLE, T1000, S40, LI 00. 
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In the following job, the COMPASS assembler is called twice. During the first assembly, binary 
object decks for subprograms TEST1 and TEST2 are written on file LGFILE1. The source decks 
for these subprograms are on the second record of the INPUT file. During the second assembly, 
COMPASS writes a binary object deck for subprogram CDA on file LGFILE2. Each assembler run 
produces a full listing. Following the second assembly, both files containing binary output are re- 
positioned to the beginning of the file. Then, the COPYBR program is called to copy the contents 
of LGFILE2 to a punch file (PUNCHB). The LGFILE1 card then calls for the loading and execution of 
subprograms TEST1 and TEST2 from LGFIEE1. Following successful execution of the subprograms, 
the file is rewound and copied to the punch file, after which the job terminates. 



6 (end of information) 

8 
9 




Data for execution 



> Subprogram CDA 



\ Subprogram TEST2 



\ Subprogram TEST1 



9 (cOPYBR(LGFILEl, PUNCHB) 

fREWIND(LGFILEl) 



LGFILE1. 



( r COPYBR(LGFILE2, PUNCHB) 



( f REWIND(LGFILE2) 
(REWIND(LGFILEl) 



( COMPASS(B=LGFILE2) 



(C0MPASS(B=LGFILE1) 



SAMPLE, T500, EC50, CM50000, 



Control 
Record 
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In the following example, COMPASS is called from within a FORTRAN program. The source program 
follows the FORTRAN program in the same record. 

No parameters on the RUN card cause: 

1. Compilation and execution 

2. Object program SCM and LCM fields to be set 

3. Source decks on INPUT 

4. Listings to be written on OUTPUT 

5. Binary object programs to be written on LGO 

6. No cross reference list is produced 



IDENT begins in 
column 11 



[RUN 



8 (end of information) 

9 



Data 



c 



(end of record) 



( END 




COMPASS Source Deck 



IDENT 



FORTRAN Source Deck 



(end-of-record) 



JOB, EC100, CM100000, P2. 



<> 




V 
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The following sample job deck illustrates how to assemble and use a system text overlay. 

TEXT, CM60000, T300. 
COMPASS (S=0, B=TEXT) 
COMPASS(G=TEXT) 
7/8/9 

IDENT TEXT 
STEXT 

Contains definitions for 
system macros, micros, 
and symbols. 
END 
7/8/9 

IDENT PROGRAM 

SST Defines symbols from TEXT. 

! Programs using definitions 
in TEXT. 

END 

6/7/8/9 
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LISTING FORMAT 



11 



This section describes assembly listing format. Control of the contents of the listing is described in 
section 4. 11 Listing Control, and in section 10. 1. 2 COMPASS Control Card. 

11.1 PAGE HEADING 

Each page of the assembly listing contains a title line and a subtitle line in the following format: 



title 


COMPASS - VER n. 


date 


time 


PAGE x 


subtitle 


sub- sub 
title 


block 
name 


symbol 
qual 


BBB 



title Up to 62 characters taken from the first TITLE pseudo instruction or from a 

TTL pseudo instruction or, in lieu of these, from the IDENT instruction. 

date Date of assembly 

time Time of assembly in hours, minutes and seconds. 

PAGE x Page number of listing. Pagination begins with 1 for each END instruction 

unless the P option is selected on the COMPASS control card 

subtitle Up to 62 characters taken from second and subsequent TITLE pseudo 

instructions or a CTEXT pseudo instruction. 

sub-subtitle Up to 10 characters taken from the most recent EJECT, SPACE, TITLE, or 

TTL pseudo instruction or the location field of an ES or PS machine instruction. 
If the instruction that introduces the new sub-subtitle also causes a page eject, 
the instruction immediately follows the heading (assuming the C list option is 
also selected). 

block name Name of the block in use at beginning of page 

symbol qual Qualifier in use (see QUAL pseudo instruction) at beginning of page 



11.2 HEADER INFORMATION 

The first page of the assembly listing for each subprogram contains a summary of binary control cards 
(optional), a list of all the blocks established for the subprogram, and lists of entry points and 
external symbols. 



11.2.1 BINARY CONTROL CARD SUMMARY 

A binary control card summary in the following format is generated for each IDENT instruction when the 
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COMPASS control card or the LIST instruction selects the B list option: 
ADDRESS LENGTH BINARY CONTROL CARDS, 

addr-^ fj binary card^ 



addr Q 



h 



binary card 2 



addr 



n 



binary cardj 



addr. 



h 




Example: 




ADDRESS 


LENGTH 


INI 


271 


37? 


52U1 


5633 


12^2 


7075 


hlhS 


1321*2 


5175 


20<»37 


1352 


22011 





H binary card 

The binary card that caused generation of the binary for the overlay, partial 
binary, or subprogram. The list includes SEG, SEGMENT, and END instruc- 
tions. 

The origin address for the subprogram, overlay, or partial binary written out 
as a result of the binary card. 

The length of the subprogram, overlay or partial binary. 



BINARY CONTROL CARDS. 

IOENT COMPASS, LOVER, CMP 

SEG 

SEG 

SEG 

SEG 

SEG 

END COMPASS 
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11.2.2 BLOCK USAGE SUMMARY 

A block usage summary of the following format is generated under control of the B list option. 



BLOCKS 

name. 

name., 



TYPE 

to 



ADDRESS 
baddr.. 

baddr 



LENGTH 
b£ 2 



name. 



baddr 



n 



bin 



name; 



type 



Name of the block used in the subprogram, as follows 
PROGRAM* 



ABSOLUTE* 

LITERALS* 
other 



For a relocatable assembly, indicates the zero 
block. For an absolute assembly, the first 
PROGRAM* indicates the absolute block, the 
second indicates the default symbols block. 

Appears in a relocatable assembly only and 
indicates the use of an absolute block. 

Identifies the literals block. 

Identifiers a local, labeled common, or blank 
common block. 



baddr. 



The type of the block as follows: 

ABSOLUTE All addresses in the block are relative to absolute 

zero. For an absolute assembly, all blocks are 
ABSOLUTE. 

LOCAL Addresses in the block are relative to the origin 

assigned to block zero. 

COMMON Addresses in the block are relative to the origin 

of the common block. 

LCM Addresses in the block are relative to the named 

LCM block for a relocatable program and are 
relative to RAL for an absolute program. 

Beginning address of the block according to type. 



length. 



Number of words in the block. 
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Examples: 



BLOCKS 


TYPF 


AP PRESS 


LENGTH 


PROGRAM* 


ABSOLUTE 





5416 


LITERALS* 


ABSOLUTE 


5416 


215 


CONTROL 


ABSOLUTE 


5613 


1242 


PSFUDO 


BBSOLUTF 


7075 


4145 


SUBS 


ABSOLUT^ 


13242 


5175 


BUFFERS 


ABSOLUTE 


20437 


11140 


BLOCKS 


TYPE 


ADDRESS 


LENGTH 


ABSOLUTE* 


ABSOLUTE 





62 


PROGRAM* 


LOCAL 





35 


DATA1 


LOCAL 


35 


1 


TABLE 


COMMON 





1 


TABLE 


LOCAL 


36 


1 


LCM 


LCM 





400 


ALPHA 


LOCAL 


37 


1751 


BETA 


LOCAL 


2010 


144 


// 


COMMON 





1000 



1 1 .2.3 ENTRY POINT LIST 

If the subprogram declares entry points, a list of entry point symbols in the following format follows the 
block usage summary. 

ENTRY POINTS. 



sym - addr 
sym 2 - addr 



sym , - addr , 
J n+1 n+1 

sym „ - addr „ 
J n+2 n+2 



Sym 2n + 1 " addr 2n + l 
Sym 2n + 2 " addr 2n + 2 



s y m ^ -, ~ addr , 
J 3n+l 3n+l 

s y m r. « - addr „ 
J 3n+2 3n+2 



sum - addr sym„ - addr„ 
n n J 2n 2n 



sym 3n -addr 3n 



lithe symbol is undefined, addr. is *******. 
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Example: 

FNTRY POINTS. 

SNAP1 - 13*5 CONOUT - 117«5 GOTO - 16 *EAC1 - 36 

SNAP2 - 1352 ADO - 13»»7 IF - 135*» RFCOPP - 37 

«NAP3 - 1357 AOOR - 12»»7 KEY - 17 RFORDF" - kD 

SNAP«» - 136* BEGIN - LABEL - 20 RPF - <tl 

SNAP5 - 1510 BYTESIZ - 1 LFVFL - ?1 «?PH - U2 

<WAP6 - 1637 CALL - 2 LIMIT 2? SC - <»3 

1 1 .2.4 EXTERNAL SYMBOL LIST 

If external symbol references are declared in the subprogram, a list of the following format follows the 
list of entry point symbols: 

EXTERNAL SYMBOLS. 

• • s y m 7n+l 



symj 


s y m n+i 


s y m 2n+l 


s y m 3n+l 


sym 2 


s y m n+2 






sym 3 


sym n+3 






sym n 


s y m 2n 







where n is l/8th the number of external symbols. 
Example: 

fXTFRNAL SYMBOLS. 

FRMSG CONEXIT XOFTRI SYMBOL COGOTO CPC 



11.3 OCTAL AND SOURCE STATEMENT LISTING 

The contents of the octal and source statement listing depends on the options selected. 
The list is 130 characters wide with fields assigned as shown in figure 11-1. 
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Title Line 



Subtitle Line 



Error 
Flags 



Location 
Addresses 



Octal 
Code 



Source Lines 



Sequence 



Figure 11-1. Format of Octal and Source Statement Listing 

Error Flags Error flags indicating that errors of the type indicated have been detected on the 

source line or in a subsequent statement that is not listed. These flags are 
described more fully under Error Directory. Lines containing errors are always 
listed. 



Location 
Addresses 



Octal Code 



The value of the location counter with leading zeros suppressed. If no code is 
generated or no location symbol is defined by the statement, this field is blank. 
If at the time the value is assigned, the value of the location counter differs from 
the value of the origin counter, an L precedes the address. 

The actual code generated by this statement. Depending on options selected, the 
listing shows just the first word or all words generated for data generation 
instructions. The field does not include NO instructions (46000„) packed for a 
force upper or zeros packed for a completed parcel on a VFD. A 24-bit PPU 
instruction is shown two words of data per line. 
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If the word contains an address, the octal code is flagged as follows: 
Negative relocatable address 



+ Postive relocatable address 

C Common relocatable address 
X External address 



For a statement that does not generate code, this field is normally blank. 
Exceptions are as follows: 

For a LIT instruction the field contains the address of the first word of 
the literals generated. 

For a COL instruction, the field contains the new beginning-of-comments 
column number. 

For a symbol defined through SET, MAX, MIN, EQU, =, or MICCNT, 
this field contains the octal value of the symbol right justified with leading 
zeros suppressed. 

For an instruction resulting in a change of base, the notation bf*b 2 is right 
justified in the field, b± indicates the old base and b 2 indicates the new base. 

For an instruction resulting in a change of code conversion, the notation 
c l r ~"' c 2 is rignt J usti fl e d in tne field. c 1 indicates the old code and c 2 
indicates the new code. 

For a DUP instruction, the field contains the repeat count. 
Source Code Source statement image (columns 1-72) 

Sequence Columns 73-90 of the card image or an identifier for an expansion of a definition 

operation as follows: 



Macro 

Remote code 
Duplicated code 
Echoed code 
XTEXT 
OPDEF 



macro name 

*RMT* 

*DUP* 

*ECHO* 

file name 

Operation field of opdef call, e.g., SB1 



The recursion level is indicated in the right half of the field. 
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Example: 



COMPASS - 6000/7OOn ASSEMBLER 
COMPASS MAIN BATCH CONTROL. 



COMPASS - VER 
COMPASS 



"•133 
".13". 
".135 
"•136 



COMPASS - MAIN CONTROL. 



■•13? 6110000001 



010002235". 



O1.O0O0733". 
0".00007571 
010000".137 
0".OOO0".133 



COMPASS sm 

RJ 
COMPASS". EO 
FXITP1 FQ 
EXITP2 RJ 



"•137 ooooooonoo 

".I".") ■511C00311.7 

512D1O0O6? 
"•1M 3661? 

5". 620 

5110003075 
".1".' 5120000077 

51300000".? 
"•1»3 51".O006566 

031101)4152 
»1"."» 033?00".151 

5120000070 
">1".5 13t?Q0".137 

5120106567 
".11.6 106?? 

51F0103171 
41<i7 0".0000".137 
".150 ".30".". 



1 (01) = CONSTANT 1 

PASSO INITIALIZE COMPASS 
/PASS1/PASS1 EXECUTE PASSl 
/PASS2/PASS2 EXECUTE PASS? 
TFE TEST FOR FNO 



COMPASS". 



CONTINUE 



70/05/05. ! 09.58.3"!. 


PAGE 


3* 




COMPASS 


007 




COMPASS 


009 




COMPASS 


■ 09 




COMPASS 


BIO 




COM'ASS 


811 




COMt ASS 


812 




COMkASS 


813 




COMPASS 


Bl"> 




COMPASS 


815 



TFE - TEST FOR END. 



PS 




RETURN EXIT 


SA1 


ERCNT 


PROPAGATE ERPOR COUNT 


SA2 


ERPFLG 




1X6 


Xl*X? 




SA6 


A? 




SA1 


EOFINP 


CHECK FOR EOR ON INPU 


SA? 


3ATCM 




S»3 


INRUFH 




SA". 


=6LIDENT 




NZ 


X1.TFF2 


IF EOR HAS BEEN FOUNO 


NG 


X?,TFE1 


IF NOT COMPASS ONLY 


SA' 


LISTFG 




NZ 


X?,TFE 


IF LIST ON 


SA? 


= 10H- 




PX6 


X? 


SET 00U9LE SPACE 


SA6 


TIT»UF 




EQ 


TFt 


RETURN 


MXO 


36 




RX1 


X3»X0^" 


~~ — —"iH^NEXT CAPO FJJJ*-"™ 



COMFASS 


817 


COMPASS 


818 


COMPASS 


B19 


COMFASS 


8?0 


COMPASS 


821 


COMPASS 


82? 


COMPASS 


823 


COMPASS 


62". 


COMPASS 


8 25 


COMPASS 


626 


COMt ASS 


827 


COMPASS 


828 


COM" ASS 


829 


COMPASS 


830 


COMf ASS 


831 


COMPASS 


832 


COMFASS 


833 


COMrASS 


83". 


COM- ASS 


835 


COMPASS 


8 36 


COMPASS 


837 


-»SS 


638 



11.4 LITERALS 

When the Dlist option has been selected, the assembly listing includes a listing of the literals block 
following the default symbols listing. Following each literal address is the octal contents of 
the word and a display code conversion of the contents of the word. 



Examples: 



Qini21 
01012? 

01112'" 

oioi2«» 

010125 
010126 
010127 
010111 

o i n in 



CONTENT OF LITERALS BLOCK. 



17^5 7 7375300 00000 

i665ooor>oooooooooooo 

1 505232^0 1(1 70 5551636 
550<*0503lli501t«t5522 
052125112?050<»570000 
552?0521251122050i»00 
00000000000000000000 
20221707220115550102 
17222<t57000000000000 



0+.>>X 

MESSAGE 73 
nFCIMftt R 

EOUTRFH. 
RFOUTRFH 



PROGRAM 
ORT. 



AB 



7315 


on?<» 


7316 


7070 


7317 


0007 


7320 


0000 


7321 


5501 


732' 


0000 


7323 


0506 


732<» 


1M1 


7325 


21*05 


7326 


2201 


7327 


H*?3 



CONTENT OF LITERALS eiOCK. 



1 
G 



FF 
LI 
TE 
RA 
LS 
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11.5 DEFAULT SYMBOLS 

When the D list option is selected, a list of default symbols immediately precedes the literals block. 

Example : 

OEFAULT SYHBOLS OEFINEO BY COMPASS 

00 00 X MSG= 

PP5i»61 TAG1 

005U6? TBG2 

005MJ7 A*?C 

T05«»6* SVM 

11.6 ASSEMBLER STATISTICS 

Assembler statistics are printed at the end of the octal and source statement listing or, if the D list 
option is selected, following the default symbols. Information includes the following: 

Amount of storage used (octal) 

Number of source statements 

Number of symbols defined 

Number of invented symbols 

Number of symbol references 

Machine on which COMPASS executed and assembly time 

Number of errors encountei'ed during assembly 

Number of lost references, that is, references to symbols that have been omitted from the 
symbolic reference table. 

11.7 ERROR DIRECTORY 

The assembly listing includes an error directory if any errors are detected during assembly. The 
directory begins a new page identified with the subtitle ERROR DIRECTORY. Each type of error that 
occurred is called out with a two-line message of the following format: 

x TYPE ERROR description 

OCCURRED ON PAGES p r Pg , Pg , . . . P n 



Types and descriptions are given in Tables 11-1 and 11-2. Errors flagged with an alphabetic character 
are fatal. A fatal er 
are informative only 



are fatal. A fatal error causes suppression of binary output. Nonfatal warning flags are numeric; they I 
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TABLE 11-1. FATAL ERRORS 



Error 
Type 



Definition 



ADDRESS FIELD BAD. 

Indicates any of a number of possible errors in a variable subfield entry. 
For example: 

CODE character not A, D, E, or I 

Symbol or name greater than 8 characters 

Expression does not reduce to one external term, relocatable terms do 

not cancel properly, instruction disallows register designators, 

instruction requires absolute expression, etc. 
Data error; 8 or 9 encountered in octal data, modifier not S, P, O, E, D, 

or B. 
No data in variable field of LIT instruction 
No symbol following an =S or =X prefix 

Relative jump out of range (-31 >r >31) on PPU instruction 
BASE character not O, M, D, or * 
Register illegal in CON instruction 

Unable to locate synonymous instruction for OPSYN or CPSYN 
Micro count less than zero or greater than ten 
NOLABEL character not I 
Negative relocation on ORG 

POS value less than or greater than word size 
VFD attempts to place relocatable address in CPU instruction when 

position counter is not 30, 15, or 
Erroneous OPDEF reference 



D 



DOUBLY DEFINED SYMBOL. THE FIRST DEFINITION HOLDS. 
Symbol previously defined or declared external 



ECHO, DUP, RMT, OR MACRO ILLEGALLY NESTED. 
Definition not wholly within next outer definition 



NUMBER OF ENTRIES EXCEEDS PERMISSIBLE AMOUNT. 

LIT generates more than 100 words 

Data missing or erroneous on XTEXT file 

More than 63 formal parameters and local names in macro definition 

More than 255 blocks 
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TABLE 11-1. FATAL ERRORS (cont'd) 



Error 
Type 



N 



O 



R 



Definition 



LOCATION FIELD BAD. 

Required location field entry is erroneous. 

Format two macro definition has no substitutable parameters. 



NEGATIVE RELOCATION ON ENTRY POINT. 



OPERATION FIELD BAD. 

Instruction unrecognizable, out of sequence (e.g. , ABS or PPU not in 
first statement group 

relational mnemonic on IF statement is erroneous. Location symbol 
begins beyond column two. 



CONSULT LISTING FOR REASON BEHIND P-ERROK. 
User-generated error flag (ERR or ERRxx instruction) 



DATA ORIGIN OUTSIDE BLOCK OR IN BLANK COMMON. 
Range error 



UNDEFINED SYMBOL. VALUE ASSUMED 0. 

Reference to a symbol that is not defined; e.g. , IF statement line count, 
DIS word count, unrecognizable attribute on IF statement, and undefined 
qualifier. 



BIT COUNT ERROR ON VFD (MUST BE Oi COUNT $ 60). 
VFD field size erroneous. 
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TABLE 11-2. INFORMATIVE ERRORS 



Error 
Type 



Description 



LOCATION SYMBOL BAD. SYMBOL NOT DEFINED. 

Location field entry erroneous. The instruction does not require an entry. 



ADDRESS ERROR ON SYMBOL DEFINITION. 

Erroneous variable field entry. The location field symbol is not defined. 



DUPLICATE MACRO DEFINITION. NEW ONE OVERRIDES. 
Macro, opdef, or synonymous operation redefines operation code. 



BAD FORMAL PARAMETER NAME IGNORED. 

Macro or ECHO formal parameter name repeated or illegal. 



CPU OPERATION SYNTAX INCORRECTLY SPECIFIED. 
OPDEF, CPOP, CPSYN, or PURGDEF specifies illegal syntax. 



LOCATION FIELD MEANINGLESS. 
Entry in location field is ignored. 



ADDRESS VALUE EXCEEDS FIELD SIZE, RESULT TRUNCATED. 

Value of expression exceeds size of destination field. 

BSS address expression value is negative. 

MICRO starting character position or character count is negative. 



MISSING OR EXTRA ADDRESS SUBFIELD. 
Variable subfield entry missing or superfluous. 



MICRO SUBSTITUTION ERROR. NO SUBSTITUTION. 
Micro reference unrecognized. 
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11.8 SYMBOLIC REFERENCE TABLE 

The assembler generates a symbolic reference table (figure 11-2) if the L list option is on at the end of 
assembly. The table is not complete if the option was turned off at any time during the assembly. The 
table lists symbols according to the qualifier, if any, under which they were defined. The global 
symbols are listed first. A new heading of the following form introduces each new list of qualified 
symbols. 

SYMBOL QUALIFIER = qualifier 
The qualifiers are in the order declared in the subprogram. Symbols are listed alphabetically. 

When symbol references are lost because table space has been exceeded, the subtitle line includes 
notification in the form n LOST REFERENCES. 



Title Line 



SYMBOLIC REFERENCE TABLE. 



Hvmbol 



value 



block 



page/line 

and/or 

address 



page/line 

and/or 

address 



page, line 
and/ or 
address 






page, line 
and / or 
address 



symbol 
value 



Figure 11-2. Format of Symbolic Reference Tabic 

Alphabetical list of symbols defined under the qualifier. 

Absolute value of the symbol or the address assigned to this symbol relative to 
the block named. 



block 



For an absolute assembly, this field is blank. For a relocatable assembly, it 
identifies the block containing the symbol. 
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page/line 



address 



flag 



From left to right and from top to bottom, a list of indices sequenced according 
to page number. Each index points to a statement containing references to the 
symbol or defining the symbol. 

When the XREF pseudo (section 4. 11. 8) has been used, the page line field contains 
the location counter address of the instruction containing the reference. Page 
and line numbers are optionally included with the address. 

Identifies page/line index to a statement that defines the symbol or uses it in an 
IF statement as follows: 



D Definition statement; EQU, =, SET, MAX, MIN, or MICCNT. 

E ENTRY pseudo instruction 

F Symbol used in conditional test 

L Symbol used in location field of the statement 

S Symbol used for storage 

X EXT pseudo instruction 



When XREF A is in effect, the table does not include the flags. 
Example: 



riMDAss - 


f00n/7nnn assfmulfp - 


VFP 










COMPASS - 


VFP 


70/05/05. 


71.1.6.1.3. 


P«GF 


1.11* 


^vwriLir 


orrcnr^f Tfl^L* 7 . 












PUSS? 












7 T LUSVM 


701,11 


15Q/?0 




717/31 
373/?? 




331./1.3 
31.0/29 


L 


31.0/1.0 
31.1/11. 


31.1/75 










JTUJ^YHl 


701,?? 


71.0/3? 




31.0/1.6 


L 


















7TLMSYH? 


70<.'O 


71.0/37 




31.0/1.1 


L 


















7TLUSYM' 


7(11,'? 


71.1/01. 




31,1/06 




31.1/11 


L 














7TLIISYW. 


711.'? 


71.0/1,5 




31.1/11 


L 


















7TUJSVM6 


'O'.'O 


31.1/01 




71,1/05 


L 


















7TLU5 


?0I»'7 


31.1/?? 




31.1/?!. 


L 
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6000 AND 7600 TIMING NOTES 



7600 CPU TIMING NOTES 

1. Times given in Table A-l include clock period known to occur before instruction issue, but do not 
consider register conflict conditions that might delay issue. 

Except for the multiply and divide units, all functional units permit new instructions to enter them 
every clock period. A new instruction may enter the multiply unit in any clock period, provided 
there was no multiply operation initiated in the preceding clock period. A new instruction can 
enter the divide unit two clock periods prior to completion of a previous divide operation. Once 
an instruction issues to a functional unit, it is executed in a fixed amount of time. No delays are 
possible. 

Times given for instructions 01 to 07 and 50 to 57 do not consider memory conflict conditions or 
SAS backup conditions caused by bank conflicts. 

2. Execution of Block Copy instructions (Oil and 012) will be delayed until the following conditions 
are satisfied: 

a. All operating registers are free. 

b. No SCM bank conflicts exist. 

c. LCM is not busy. 

d. All LCM banks have completed previously initiated read/write cycles. 

3. A delay will occur during instructions 011, 012, and 013 when an I/O multiplexer request is made. 
A minimum delay of one clock period is required to enter the I/O word address in the address 
stream to the SAS. An additional delay will occur if the I/O reference causes a bank conflict in 
SCM. 

4. A delay will occur in the execution of the Exchange Exit instruction (013) until two conditions are 
satisfied: 

a. All operating registers are free. 

b. No SCM bank conflicts exist. 

5. The Read LCM and Write LCM instructions (014 and 015) will not issue until three conditions are 
satisfied: 

a. LCM is not busy. 

b. Xj register is free. 

c. Xk register is free. 
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6. A Read LCM instruction (014) for a word already residing in an LCM bank operand register as a 
result of a previous instruction will require three clock periods. For a word not currently residing 
in one of the LCM bank operand registers, the instruction requires 17 clock periods. 

7. The Reset Buffer instructions and Read Channel Status instructions (016 and 017) will not issue 
and begin execution until the required B registers are free. 

8. Jump instruction 02iOK will not begin execution until the Bi register is free. Instruction 
execution will also be delayed if an instruction fetch is in process. 

9. The execution of a branch instruction (030 to 037, 04ijk, 05ijk, 06ijk, and 07ijk) may be delayed if 
an instruction fetch is in process. 

10. Instructions 10 to 47 and 60 to 77 will not issue until the following conditions are satisfied: 

a. The required A, B, and X registers are free. 

b. X and B register input paths will be free during the required clock period. 

c. No SAS backup condition exists. 

d. The multiply unit is free (instructions 40, 41, and 42 only). 

e. The divide unit is free (instructions 44 and 45 only). 

11. Instructions 50 to 57 will not issue until the following conditions are satisfied: 

a. The required A, B, and X registers are free. 

b. No SAS backup condition exists. 

12. A delay may occur in the execution of the Return Jump instruction (0100K) if the instruction stack 
control has requested one or more instruction words that have not arrived at the instruction stack 
(likely to occur in straight line coding). Average execution time is 18 clock periods. 

13. A register is reserved if it is the destination of an instruction that has been initiated but has not 
completed. A register is free in the clock period following the store into it. 
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6600/6700 CPU TIMING NOTES 

1. The times given in Table A-l are computational times - the time needed after the execution start 
until the result is computed and ready to be stored into the result register. 

2. The functional units are not freed until one minor cycle after the result has been stored into the 
result register. 

3. A result register value may be used as an operand to another instruction as soon as the result has 
been stored into the register (same minor cycle). This result register will not be freed to be used 
as a result register of another instruction until one cycle after the result has been stored into that 
register (no trunk priority considered). 

4. An instruction is issued to a functional unit if: 

a. The word containing the instruction is in the stack and the U registers, 

b. The functional unit(s) needed are free, and 

c. The result register(s) needed are free (note Table A-2 and A-3). 

If these three conditions are not met, all further instruction issues are held until they are satisfied. 
Each issued 15-bit instruction requires one minor cycle before the next instruction is available for 
issue. Each issued 30-bit instruction requires two minor cycles before the next instruction is 
available for issue. 

5. Execution within a functional unit does not start until the operands are available (note Table A-3). 
The two operands required are fetched from the registers at the same time (one operand is not 
loaded while the unit waits for a second operand). 

6. In instructions 02-07, where more than one functional unit is used, the instruction is not issued 
until both functional units involved are free. 

7. Times given for instructions 01-07 and 50-57 do not consider any memory conflict conditions. 

8. In instructions 50-57, if i = 1,2. . .5 (load from memory instructions), the Xi register value is 
not available until 8 minor cycles after the start of the instruction execution (assuming no memory 
conflicts). When two load instructions begin execution one minor cycle apart, one extra minor 
cycle is required for execution of the later instruction. Therefore, the second executed instruction 
would require 9 cycles for the load, 5 cycles for the increment unit, and 4 cycles for the A 
register. 

9. In instructions 50-57, if i = 6 or 7 (store to memory instructions), the Xi register is not available 

for a result register until 10 minor cycles after the instruction begins execution (assuming no 
memory conflicts). When two store instructions begin execution one minor cycle apart, one extra 
minor cycle is required for execution of the later instruction. Therefore, the second executed 
instruction would require 11 cycles for the store, 5 cycles for the increment unit, and 4 cycles for 
the A register. 



t The 6700 also includes a 6400-type CPU. 
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10. When executing sequential instructions that are not in the stack, the minimum time is one word of 
instructions every 8 cycles. The time of issue of the last parcel of an instruction word to the time 
of issue of the frist parcel of the next instruction word (while executing sequential instructions 
that are not in the stack) requires a minimum of 4 cycles. If the last instruction in an instruction 
word is a 30-bit instruction, a minimum of 5 cycles is required from the time of issue to a 
functional unit of this instruction to the time of issue of the first instruction in the next word. 
An instruction word is parcelled as shown below: 



Parcel 


Parcel 1 


Parcel 2 


Parcel 3 



59 45 30 15 00 

11. When a branch is taken out of the stack, 15 minor cycles are normally required for a 03ijk 
instruction, and 14 minor cycles are normally required for other branch instructions (considering 
no memory conflict). The latter timing is from the start of branch instruction execution to the 
point where the instruction at the branch address is ready for issue to a functional unit. 

12. Nine cycles are required for 03ijk instructions when the branch is taken within the stack. The 
next sequential word is recognized as being within the stack. 

13. Eight cycles are required for 04ijk to 07ijk instructions when the branch is taken within the stack. 
The next sequential word is recognized as being within the stack. 

14. Eleven cycles are required for 03ijk instructions when the branch is not taken (time from branch 
execution to issue, of next instruction) if in the stack or if falling through to the same word. Out of 
the stack fall -through to the next word takes 14 cycles, 

15. Ten cycles are required for 04ijk to 07ijk instructions when the branch is not taken (time from 
branch execution to issue of next instruction) if in the stack or if falling through to the same word. 
Out of the stack fall-through to the next word takes 13 cycles. 

16. The BO register is handled as any other Bi register for timing purposes (e.g. , BO delays execution 
of an instruction if it is a result register of a previous non-completed instruction). 

17. Neither increment unit may be involved in a load operation if a store operation is to be issued, and 
neither increment unit may be involved in a store operation if a load operation is to be issued. The 
sequential loading of instruction words does not affect the load/store conditions of the increment 
units. Increments of A0 are considered neither loads nor stores. 

18. The operand registers are available to more than one functional unit in the same minor cycles if the 
units are in different groups. 

Group 1 Group 2 Group 3 

Boolean Shift Increment 1 

Divide Floating Add Increment 2 

Multiply 1 Long Add 
Multiply 2 

19. The time needed for a functional unit to operate on indefinite, out-of- range, or zero values is the 
same as for normal, in- range values (i.e. , no gain or loss in execution time due to a unit 
recognizing an indefinite operand and setting an indefinite result). 



A-4 6 0279900A 



20. An Index Jump instruction (02) always voids the stack. If an unconditional jump back in the stack is 
desired, a 0400K instruction may be used (to save memory access time for instructions). 

21. A Return Jump instruction (01) always voids the stack. 

22. After a result has been computed by a functional unit, the result register is checked to see if it is 
still needed as an operand register for a previously issued instruction. This is done so that a 
result will not overlay an operand to a previously issued instruction. If a unit (#1) is waiting for 
an operand to be fetched by another unit (#2) before storing its result, for timing considerations, 

a. the result register is available to a third unit (#3) as an operand, the cycle following the 
fetch, and 

b. the unit (#1) is freed two cycles following the fetch. 

23. In cases of bank conflict, unaccepted addresses get a chance at access every three minor cycles. 
If the address can then be accessed, the memory operation proceeds. If the bank is still busy, 
the address circulates in the hopper, while access is permitted for any other source requesting 
access. 

6000-SERIES PPU TIMING NOTES 

The execution time of peripheral and control processor instructions (Table A-4) is influenced by the 
following factors : 

1. Number of memory references. Indirect addressing and indexed addressing require an extra 
memory reference. Instructions in 24-bit format require an extra reference to read m. 

2. Number of words to be transferred. In I/O instructions and in references to central memory the 
execution times vary with the number of words to be transferred. The maximum theoretical 
rate of flow is one word/major cycle. I/O word rates depend upon the speed of external 
equipments which are normally much slower than the computer. 

3. References to central memory may be delayed if there is conflict with central processor 
memory requests. 

4. Following an exchange jump instruction, no memory references (nor other exchange jump 
instructions) may be made until the central processor has completed the exchange jump. 
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7600 PPU TIMING NOTES 

1. Where more than one time is given, the shorter time is obtained when full use of bank phasing 
(back-to-back storage references to alternate banks) is made. 

2. Conditional jump instructions list times for the jump not taken case. Add 3 or 5 clock periods 
for the jump taken case, depending on the value of d. 

3. For the 10 (shift) instruction: Minimum time required if the shift count £ 3; for shift counts > 3, 
add 1 clock period per shift beyond 3 to the minimum time. 



4. 



71 Instruction: 
Case 1: 



Case 2: 



Assume - a. a block input terminated by a record flag rather than by decrementing 
(A) to zero. 

b. a 2-clock period response time between the resume and the word 
flag. 

c. a 3-word block followed by a record flag. 

d. the channel d input word flag is set at instruction initiation, and 

e. the first data reference is to the alternate storage bank. 

Execution Time = 42 Clock Periods 

Assume - a. a block input terminated by reducing (A) to zero. 

b. same response as in Item b, Case 1. 

c. a count of 2 in the A register, and 

d. items d and e in Case 1 are true. 

Execution Time = 24 Clock Periods 



Case 3-: 

5. 73 Instruction: 
Case 1: 



Case 2: 



Assume - a. a block input initiated with (A) = zero. 
Execution Time = 10 Clock Periods 

Assume - a. a count of 3 in the A register. 

b. the device has a 2-clock period response time from receipt of word 
pulse to transmission of resume pulse. 

c. the output channel d word flag is clear, and 

d. the first word of the block is read from the alternate storage bank. 

Execution Time = 34 Clock Periods 
Assume - a. a block output initiated with (A) = zero. 
Execution Time = 10 Clock Periods 
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TABLE A-2. FUNCTIONAL UNIT DATA TRUNK ASSIGNMENTS AND PRIORITY 



FUNCTIONAL UNIT 


RESULT (i) 


OPERAND fl) 


OPERAND (k) 


Trunk Priority 


Trunk Priority 


Trunk Priority 


Group 1: Shift 

Add 
Long Add 


3 < X >1 + 1 

4 (B) f ? 

3 J 2 
3 3 


1 2 

1 1 
1 3 


2 2 

2 1 
2 3 


Group 2: Boolean 
Divide 
Multiply 1 
Multiply 2 


7 1 
7 2 
7 3 

7 4 


5 4 
5 1 
5 2 
5 3 


6 4 
6 1 
6 2 
6 3 


Group 3: Increment 1 
Increment 2 


10 1 
10 2 


8 1 
8 2 


9 1 
9 2 



t The Shift Unit is sometimes required to store two results at one time: one into an X register and one 
into a B register. 
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TABLE A-3. 6600/6700 REGISTER RESERVATION CONTROL 



INSTRUCTION 



Branch Unit 
02ijK 
03ijK 
04ijK 

Boolean Unit 
lOijk - 17ijk 

Shift Unit 

20ijk - 23ijk 
24ijk - 26ijk 
27ijk & 43ijk 

Add Unit (Floating) 
30ijk - 35ijk 

Long Add (Integer) 
36ijk - 37ijk 

Multiply (2 Units) 
40ijk - 42ijk 

Divide Unit 
44ijk - 47ijk 

Increment (2 Units) 
50ijK 
51ijK 
52ijK 
53ijk 

54ijk &' 55ijk 
56ijk & 57ijk 
60ijK 
61ijK 
62ijK 
63ijk 

64ijk & 65ijk 
66ijk & 67ijk 
70ijK 
71ijK 
72ijK 
73ijk 

74ijk & 75ijk 
76ijk & 77ijk 



XBA RESULT 
REGISTER (ISSUE) 



Xi 



Xi 

Xi & Bj 

Xi 



Xi 



Xi 



Xi 



Xi 



Ai & Xit 

Ai & Xit 

Ai & Xit 

Ai & Xit 

Ai & Xit 

Ai & Xit 

Bi 

Bi 

Bi 

Bi 

Bi 

Bi 

Xi 

Xi 

Xi 

Xi 

Xi 

Xi 



Q OPERAND 
REGISTER (EXECUTION) 



Bi & Bj 
Xi& Xj 
Bi & Bj 



Xj & Xk 



Bj & Xk 
Bj & Xk 
Bj & Xk 



Xj & Xk 



Xj & Xk 



Xj & Xk 



Xj & Xk 



Aj & Bk1t 
Bj & Bktt 
Xj & Bktt 
Xj & Bk 
Aj & Bk 
Bj & Bk 
Aj & Bktt 
Bj & Bktt 
Xj & Bktt 
Xj & Bk 
Aj & Bk 
Bj & Bk 
Aj & Bktt 
Bj & Bktt 
Xj & Bktt 
Xj & Bk 
Aj & Bk 
Bj & Bk 



"I" The Xi register is considered only when i = 1, 2. . . 7. 

tt k here refers to the high order 3 bits of 18-bit address field. 
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TABLE A-4. PERIPHERAL PROCESSOR INSTRUCTION TIMES 







7600 


6000-SERIES 


INSTRUCTION CODE 




EXECUTION TIME 


TIME (MAJOR 


(OCTAL) 


NAME 


(CLOCK PERIODS) 


CYCLES) 


00 


Error stop 


- 


- 


0100 


Long jump to m 


10 or 15 


2 or 3 


Olxx 


Long jump to m + (d) 


15,20,25 




0200 


Return jump to m 


15 or 20 


3-4 


02xx 


Return jump to m + (d) 


20,25,30 




03 


Unconditional jump d 


8,10 


1 


04 


Zero jump d 


5 


1 


05 


Nonzero jump d 


5 


1 


06 


Positive jump d 


5 


1 


07 


Negative jump d 


5 


1 


10 


Shift d 


Min 6, Max 34 


1 


11 


Logical difference (A) - d 


5 


1 


12 


Logical product (A) * d 


5 


1 


13 


Selective clear (A) 


5 


1 


14 


Load to A 


5 


1 


15 


Load complement d to A 


5 


1 


16 


Add d to A 


5 


1 


17 


Subtract (A) - d to A 


5 


1 


20 


Load dm to A 


10 


2 


21 


Add dm to A 


10 


2 


22 


Logical product (A) * dm to A 


10 


2 


23 


Logical difference (A)-c to A 


10 


2 


24 


Pass 


5 


1 


25 


Pass 


5 


1 


26 


Pass 


5 


1 


260 


Exchange jump 


- 


It 


260 


6416 Extended transfer 


- 




261 


Monitor exchange jump CPU d 


- 




27 


Pass 


5 


1 


270 


Read program address of CPU d 


- 




270 


6416 Extended read status 


- 




30 


Load (d) to A 


15 


2 


31 


Add (d) to A 


15 


2 


32 


Subtract (A)-(d) to A 


15 


2 


33 


Logical difference (A)-(d) to A 


15 


2 


34 


Store (A) to d 


15 


2 


35 


Replace add (d) + (A) to d 


25 


3 


36 


Replace add one (d) + 1 to d 


25 


3 


37 


Replace subtract one (d) -1 to d 


25 


3 


40 


Load ((d)) to A 


15,25 


3 


41 


Add ((d)) + (A) to A 


15,25 


3 


42 


Subtract (A) - ((d)) to A 


15,25 


3 


43 


Logical difference (A) - ((d)) to A 


15,25 


3 


44 


Store (A) to (d) 


15,25 


3 


45 


Replace add (A) to ((d)) to (d) 


25,35 


4 


46 


Replace add one ((d)) + 1 to (d) 


25,35 


4 


47 


Replace subtract one ((d)) -1 to (d) 


25,35 


4 


5000 


Load (m) to A 


20 


3 


50xx 


Load (m + (d)) + (A) to A 


20,30 


3,4 


5100 


Add (m) 


20 


3 


51xx 


Add (m + (d» 


20,30 


3,4 


5200 


Subtract (m) 


20 


3 


52xx 


Subtract (m + (d)) 


20,30 


3,4 


5300 


Logical difference (m) 


20 


3 



t Though the execution time for this instruction in the Peripheral and Control Processor is only 1 major cycle, a minimum 
of 2 major cycles is required to complete the Exchange operation in Central Memory. Thus, Central Memory honors no 
requests for access for a minimum of 2 major cycles during an Exchange Jump. 
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TABLE A-4. PERIPHERAL PROCESSOR INSTRUCTION TIMES (cont'd) 







7600 


6000 SERIES 


INSTRUCTION CODE 




EXECUTION TIME 


TIME (MAJOR 


(OCTAL) 


NAME 


(CLOCK PERIODS) 


CYCLES 


53xx 


Logical difference (m + (d)) 


20,30 


3,4 


5400 


Store (m) 


20 


3 


54xx 


Store (m + (d)) 


20,30 


3,4 


5500 


Replace add (m) 


30 


4 


55xx 


Replace add (m + (d)) 


30,40 


4,5 


5600 


Replace add one (m) 


30 


4 


56xx 


Replace add one (m + (d)) 


30,40 


4,5 


5700 


Replace subtract one (m) 


30 


4 


57xx 


Replace subtract one (m + (d)) 


30,40 


4,5 


60 


Central read (A) to d 


- 


Min 6 


60 


Jump on input word flag 


10+t 


- 


61 


Central read (d) words (A) to m 


- 


5 + 5/word 


61 


Jump if no input word flag 


10 


- 


62 


Central write (A) words 


- 


Min 6 


62 


Jump on input record flag 


10 


- 


63 


Central write (d) words to (A) from m 


- 


5 + 5/word 


63 


Jump if no input record flag 


10 


- 


64 


Jump to m if channel d active 


- 


2 


64 


Jump on output word flag 


10 


- 


65 


Jump to m if channel d inactive 


- 


2 


65 


Jump if no output word flag 


10 


- 


66 


Jump to m if channel d full 


- 


2 


66 


Jump on output record flag 


10 


- 


67 


Jump to m if channel d empty 


- 


2 


67 


Jump if no output record flag 


10 


- 


70 


Input to A from channel d 


9t 


2 


71 


Input (A) words to m from channel d 


tit 


4 + 1/word 


72 


Output from A on channel d 


9'1t 


2 


73 


Output (A) words from m on channel d 


trt 


4 + 1/word 


74 


Activate channel d 


- 


2 


74 


Output record flag on channel d 


5 


- 


75 


Disconnect channel d 


- 


2 


75 


Pass 


5 


- 


76 


Function (A) on channel d 


- 


2 


76 


Pass 


5 


_ 


77 


Function m on channel d 


- 


2 


77 


Error stop 


(restart 
only by a 








deadstart) 





t Assume input channel d word flag is set; if not set, add the time waiting for flag to set. 

tt Jump instruction times are for the jump not taken case. The jump taken execution time is identical if the jump is to an 

alternate bank. If the jump is taken to the same bank, add 5 clock periods. 
ttf Timing for these instructions are sample times only for various cases, 
tiff Assumes output channel d word flag is clear; if not clear, add the time waiting for flag to clear. 
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BINARY FORMATS 



B 



This appendix describes the various binary formats that can be generated by the COMPASS assembler -jr. 
The types of binary formats are as follows: 

CPU relocatable 

CPU absolute 

7600 PPU absolute 

6000 Series PPU absolute 



RELOCATABLE SUBPROGRAM 

Output for a relocatable subprogram consists of a logical record composed of an indefinite number of 
tables. Each table is preceded by an identification word of the following form: 



59 54 




36 


27 


18 




00 


ca 


wc 


M88M 


ir 


t 



ID Word Format 
Bits Field Description 

59-54 en Octal code Number identifying table type as follows : 

77 Prefix table 

34 Program identification and length table (PIDL) 

36 Entry point table (ENTR) 

40 Text and data table (TEXT) 

42 Fill common area table (FILL) 
44 External reference table (LINK) 

43 Replication table (REPL) 
46 Transfer table (XFER) 

53-36 wc Octal count of number of 60-bit words in the table, excluding the identification word. 

35-27 none Reserved for future system use. 

26-18 jfr In TEXT table, indicates method of relocation for the load address; otherwise, the field 

is ignored by the loader. 

17-00 jf In TEXT table, indicates beginning location for data in the table; in the REPL table, 

this field indicates immediate or deferred replication. For all other tables, the field 
is zero and is ignored by the loader. 



|For SCOPE 2, 7600 COMPASS Version 2 generates the tables described here when the E or E=0 option 
is selected on the COMPASS control statement. Extended tables are described in the Loader Reference 
Manual, Publication No. 60344200. 
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Prefix Table (prefix) 

The prefix table is described here for all binary formats. Generation of the table can be suppressed 
through use of the NOLABEL pseudo instruction. 



Prefix Table: 


59 54 


48 


36 




18 




op 


ID Word 


77 


00 


0016 


0000 


0000 


0000 


1 


name 


000000 


2 


date 


3 




4 




5 






:=^~-->__ comments 






. 




^ = ^==--~-__ 




_— ^=^H 


16 8 





Word Bits 



59-18 



Field 



name 



Description 

Name of record in display code from IDENT or SEGMENT 
pseudo instruction left justified with zero fill. 



17-00 
2 59-00 



3-16 c 



date 



comments 



Reserved for future system use. 

Date of assembly in the form 

a yr/mo/dy. 

where month (mo), day (dy), and year (yr) are each two display 
code digits. 

Display code text from COMMENT pseudo instruction, left 
justified with zero fill. 
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Program Identification and Length Table (PIDL) 

The PIDL table contains the name and length of the subprogram block and each of the common blocks. 
The only table that can precede it is the PREFIX table. The entries starting with the third word 
comprise a table within the PIDL, called the Local Common Table (LCT). This embedded table lists 
labeled common and blank common blocks in the order in which they are established in the subprogram. 
Relocation of addresses in subsequent loader tables is relative to common blocks according to the 
position of the block name in the LCT. The first word in the LCT is position 1. 

PIDL Table: 



ID Word 
1 

2 
3 

4 



wc-1 
wc 



59 



54 48 



36 



18 



00 



34 


00 


wc 


0000 0000 0000 


subp name 


P2 


common name.. 


bje x 


common name„ 


bi 2 


___ common name^ 


hi 


~~~" ==:= ======= === — ^==^== ==== ^~~ 


bjex-"2~~~~| 


common name x _^ 


bjC x _! 


common name x 


bl x 



YLCT 



Word Bits 



Field 



Description 



ID 53-36 

159-18 
17-00 

( 59-18 



2-wc 



wc Length of LCT plus 1, in octal 

subp name Name of subprogram in display code as taken from IDENT pseudo 

instruction, left justified with zero fill. 
p£ Length of subprogram including all local blocks with exception of 

absolute block if there is one. 

commonnamej Name of common block as declared on USE pseudo instruction. 
For blank common, name is 7 display code blank characters. 



17-00 



bl. 



Length of the common block, in octal. 

For COMPASS 2 under SCOPE 2, blocks declared by USELCM 
have bit 17 set to one and bits 16-00 contain the integer part of 
(block length + 7) / 8. For all other systems, blocks declared by 
USELCM are not recorded in the PIDL table. 
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Entry Point Table (ENTR) 

An entry point table lists each entry point symbol to the subprogram as declared on an ENTRY pseudo 
instruction, and the labeled common block containing the entry point symbol. ENTR table must 
immediately follow the PIDL table. Each entry is two words. 



ENTR Table: 
ID Word 
Word 1 

2 

3 

4 

wc-1 
wc 



59 54 4£ 


i 3£ 


i 24 


18 


0( 


36 


00 


wc 


000000000000 


eptsym-L 


000000 


000000000000 


«. 


lOCj 


eptsym 2 


000000 


OO^O^OOO^OO 


r «2 


loc 2 


eptsym Q 


000000 


000000000000 


«n 


loc n 



Word Bits 



1,3, 



2,4 



wc 



/ 59-18 



• • • » < 

wc-1 



17-00 
/ 59-27 
26-18 



Field 



eptsym. 



none 



none 



rfc 



Description 

Name of entry point symbol in display code specified on ENTRY 
pseudo instruction, left justified with zero fill. 

Reserved for future use. 
Reserved for future use. 

Relocation for address loc: 

000 Absolute relative to RAS (no relocation) 

001 Program relocation 



003-077 Relative to the common block named in position 

rf-2 in the LCT. It cannot be the number for the 
blank common block. 



17-00 



loc. 



Address of entry point relative to block origin. 
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Text and Data Table (TEXT) 

A TEXT table contains an origin for data, indicators for relocating the data in the table, and data. The 
subprogram can contain any number of TEXT tables which can be in any order. 



TEXT Table: 

ID Word 

Word 1 

2 

3 

4 



wc-1 

wc 



59 54 48 



36 



27 



18 



00 



40 


00 


wc 


000 


£r 


a 


rb l 


rb 2 


rb 3 


■ ., , 1 , , , ; 1 , , , , 

II ' 1 | 1 | 1 1 1 1 
1 1 III II 1 III 


data word-^ 


data word2 


data word„ 










^^ 


h^— 






■ — 


data word wc _ 1 



Word Bits 
/ 53-36 



ID 



26-18 



17-00 



59-56 
55-52, 

• • • » 

03-00 



Field 



wc 



Sx 



rbi 



Description 

Number of data words in the table plus one; wc must be in the 
range 2-20g. 

Relocation of load address 1. 

000 Absolute relative to RAS (no relocation) 

001 Relative to subprogram origin 

003-077 Relative to common block named in position rjf-2 in the 
LCT. It cannot be the number for the blank common 
block. 

Beginning load address relative to block origin for data beginning 
in Word 2# The load address is relocated according to r£. 

Up to 15 4-bit relocation bytes describing address relocation 
according to the three possible positions of addresses in a 60-bit 
word. The first byte (bits 59-56) describes the relocation for the 
first data word (Word 2). The second byte describes the re- 
location for the second data word (Word 3), etc. The bytes 
permit independent and simultaneous relocation of both upper and 
lower addresses. Relocation is relative to program origin 
(positive) or to the complement of program origin (negative) as 
follows : 
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2-wc 



59-00 



data word. 



Byte Significance 

OOOx No address relocation 

lOxx Upper address, program relocation 

llxx Upper address, negative relocation 

01 Ox Middle address, program relocation 

Ollx Middle address, negative relocation 

1x10 Lower address, program relocation 

lxll Lower address, negative relocation 

0010 Lower address, program relocation 

0011 Lower address, negative relocation 

Note that an address is either not relocated (absolute) or it 
is relocated relative to program origin. It cannot be relocated 
relative to a labeled common block. Thus, TEXT tables cannot 
be used to relocate addresses relative to labeled common. This 
must be accomplished through FILL tables. 

Data words to be stored beginning at absolute address or 
relocated address indicated in the ID word. 



Fill Common Area Table (FILL) 

The FILL table specifies relocation of addresses in words already loaded through TEXT tables. 
References to common blocks are relocated through this table. Although program relocation is also 
possible through use of the FILL table, the usual method requiring fewer words is through the TEXT 
table. 



FILL Table: 
ID Word 
Word 1 
2 
3 

wc 



59 



54 48 



36 



30 



00 



42 


00 


wc 


000000000000 


byte^^ 


byte 2 


byte 3 


byte4 


byte 5 


byte 6 


r^^^^r^— 


[__-== ====:: H 


b y te n-i 


byte n 



Words 1 through wc are divided into two types of 30-bit bytes, control bytes and data bytes. 
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Control Bytes - Each control byte (indicated by a in bit 29) specifies the relocation of addresses in 
the data bytes following it until the next control byte. A control byte has the following format: 



V///////////A 



ar 



29 



08 



00 



ar Relocation of addresses in words already loaded. 

000 Absolute relative to RAS (no relocation) 

001 Positive program relocation relative to program origin. 

002 Negative program relocation relative to program origin. 
003-077 Relative to common block named in position ar-2 in the LCT. 



Data Bytes - Each data byte (indicated by a 1 in bit 29) identifies a word containing a reference address 
that requires relocation and specifies where the word containing the reference is located. The format 
of a data byte is as follows: 





1 


P 


rje 


loc | 


2 


9 




26 




17 00 


Bits 


Fiel 


d 




Description 


28,27 


P 






Position within word of address to be relocated 
10„ Upper 
01 2 Middle 
00 Lower 


26-18 


n 






Relocation of address loc: 












000 Absolute relative to RAS 



17-00 loc 



001 Program relocation relative to program origin 
003-077 

Relative to block named at position rj?-2 in the LCT. 

Address of word containing the address to be modified. The address is modified 
by adding the relocated origin for the block specified by ar. A word that contains 
two addresses requires two data bytes. 



Replication Table (RE PL) 

The REPL table directs the loader to generate one or more copies of data immediately or at the end of 
loading so that fewer TEXT tables are required. Each entry contains two words of information obtained 
from a REP or a REP1 pseudo instruction or resulting from 5 or more BSSZ instructions. 
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REPL Table: 


ID Word 




Word 


1 




2 




3 




4 




wc-1 




wc 


Word 


Bits 



ID 



00 



/ 59-27 



1,3,5,{ 26-18 

■ • • , 

WC-1 



V 17-00 

/ 59-42 

41-27 



2,4,6, 






26-18 
17-00 



59 54 48 


42 




36 




27 


18 




00 


43 


00 




wc 


00000000000 


i 




incj 


sr l 


saddr. 






rep x 


bsz^ 


dr! 


daddr^ 




inc 2 


sr 2 


saddr 2 




rep 2 


bsz 2 


dr 2 


daddr 2 




—.meg 








sr n 








inc n 






saddr n 




rep 


n 


dr 


daddr 
n 







Field 



mc. 



sr. 
i 



saddr. 



rep 
i 



bsz. 



dr. 



daddr. 
i 



Description 

Indicates whether text is to be duplicated immediately (1) 
or is to be deferred until all text is loaded (0). 

Number of words in each copy of the text. If inc. is 0, the 
loader uses bszj as the increment size. The loader writes 
the first copy starting at daddr., the second starting at 
daddrj + inCj, the third at bszj + 2 inc i( etc. until the rep. 
count is exhausted. 
Relocation of saddr. 



000 
001 
003-077 



Absolute relative to RAS 

Relative to program origin 

Relative to block named in position sr-2 of the LCT. 



First word address of source data (text to be copied); must be 
nonzero. 

Number of times text is to be copied. When rep. is 0, the loader 
makes one copy. 

Number of words to be copied (block size). When bsz. is 0, the 
loader copies one word. 

Relocation of daddr.; range of values same as sr. 

Destination address of first word of first copy. If daddr. is 0, 
the loader uses saddr. + bszj. 
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External Reference Table (LINK) 

The LINK table contains an entry for each external symbol reference declared in the subprogram. Each 
entry consists of a 60-bit field for the symbol followed by an indefinite number of 30-bit contiguous data 
bytes. 



LINK Table: 
ID Word 
Word 1 
2 
3 



59 54 



48 



36 30 



18 



00 



wc 



44 00 



wc 



000000000000 



external symbol. 



byte-, 



byte a 



byte c 



"byte 




symbol 



000000 



byte 



external symbol 



byte 



000000 



byte 5 



external 



byte 



byte 



000000 



byte 



It is possible for a symbol to be split between two words. However, if the upper half of a word is a 
data byte and the lower half is all zeros, the loader takes the zeros as filler rather than the first half 
of an external symbol; this may be used to avoid having an external symbol split between two words. 
Each symbol must begin with a character for which the display code representation is not greater than 
37 (has a high order bit of 0). The 1-7 character symbol is placed in the 60-bit field left justified with 
zero fill.« 

Each byte (indicated by a 1 in bit 29) identifies a word containing a reference to the external symbol and 
specifies the position at which the address for the symbol is to be inserted. The format of a data byte 
is as follows: 



1 p 




r£ 


loc | 


29 


26 




17 00 


Bits 


Field 




Description 


28,27 


P 




Position within word oi 
10„ Upper 

01 2 Middle 
00 Lower 



26-18 n 



17-00 loc 



Relocation of address loc: 

000 Absolute relative to RAS 

001 Relative to subprogram origin 

003-077 Relative to block named at position rf-2 in the LCT. 

Address of word containing the external reference. The address of the external 
symbol is inserted at the position indicated. 
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Transfer Table (XFER) 

The last table in a relocatable subprogram is the XFER table. 



XFER Table: 
ID Word 
Word 1 



59 54 48 


36 


18 00 


46 


00 


0001 


000000000000 


eptsym 


000000 



eptsym symbol to which control transfers when loading is complete. It is a 1-7 character 

entry point symbol in display code, left justified with zero fill. It need not be in the 
same subprogram as the XFER table. At least one subprogram of a program must 
name a transfer point; otherwise, SCOPE aborts the job with the comment NO 
TRANSFER ADDRESS. If more than one of the subprograms has a transfer point, 
the loader gives control to the last one encountered. 

The location of the entry point is returned following a loader request. 

If the first character of eptsym is blank (55 g ) the XFER table is ignored. 
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CPU ABSOLUTE SUBPROGRAM OR OVERLAY 

The binary output for an absolute CPU subprogram or overlay consists of a logical record that may 
contain: 

A prefix table (optionally suppressed through NOLABEL) 

A 50g or 51 8 table (optionally suppressed through NOLABEL) 

An absolute image of text. 

For a description of the prefix table, refer to the Relocatable Subprogram description. 

Single Entry Point Table (50) 

Following the prefix table but preceding the absolute text for a subprogram or overlay containing a 
single entry point is a control table of the following format: 



59 54 



48 



42 



36 



18 



00 



50 


00 


h 


H 


fwa 


eptaddr 



Bits Field 



47-42 L 



41-36 H„ 



35-18 fwa 



17-00 eptaddr 



Description 

Indicates primary level of the subprogram or overlay. It is determined by an 
IDENT or SEGMENT pseudo instruction as follows: 

00 First IDENT 

01 SEGMENT, or IDENT other than first that does not specify a primary 



n 



level. 

2 octal digit specified on IDENT 



Indicates secondary level of the subprogram or overlay. It is determined by an 
IDENT or SEGMENT pseudo instruction as follows: 

00 First IDENT, jr IDENT that does not specify a secondary level, or any 

SEGMENT. 



n 



2-octal digit specified on IDENT 



Origin -1 t address where 50-table is loaded as specified on the IDENT or 
SEGMENT pseudo instruction. 

Absolute address of entry point specified on the IDENT or SEGMENT pseudo 
instruction. 
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Multiple Entry Point Table (51) 



A CPU overlay that has multiple entry points has a 51 table in place of a 50 table. The table has 
the following format: 

59 54 . 48 42, 36 18 

ID Word 



Word 


1 




2 




3 




wc-1 




wc 


Word 


Bits 




i 47-36 


ID 


35-18 




1 17-00 


1,2,3, 


[ 59-18 


• • • J 


I 17-00 



00 



51 



no 



fwa 



eptsym 1 



eptsym 2 



eptsym wc _ 2 



eptsym 



eptsym, 



WC-1 



wc 



wc 



eptaddr., 



eptaddr„ 



eptaddr- 



eptaddr 



eptaddr, 



wo-1 



Wjl_ 



wc 



Field Description 

jf, ,H 2 Same as £-, and £ 2 in 50 control word. 

fwa Origin -wc-1-address where 51-table is loaded as specified on the 

IDENT pseudo instruction 

wc Length of table in octal, excluding ID word. 

eptsym. Entry point symbol in display code, left justified with zero fill, 

eptaddr. Absolute address of eptsym. 



7600 PPU ABSOLUTE PROGRAM OR OVERLAY 

Binary output for a 7600 PPU program or overlay is a logical record that may contain the following: 

A prefix table (optionally suppressed through NOLABEL) 

A 52 Q binary control table (optionally suppressed through NOLABEL) 

o 

Absolute image of all text generated since previous IDENT pseudo instruction. 
PPU text is generated 5 PPU words per 60-bit CPU word. 

The format of the control table is as follows: 



59 54 


48 


36 




24 


12 




00 


52 


00 


PPU no. 


fwa 


eptaddr 


length 



Bits 

47-36 

35-24 



Field 
PPU no. 
fwa 



23-12 eptaddr 
11-00 length 



Description 

Number of PPUs in which program or overlay is to be executed. 

Origin -5 as specified on the IDENT pseudo instruction; address at which 52-table 
is loaded 

Absolute address of the entry point specified on the IDENT pseudo instruction. 

Number of CPU words in the program or overlay image including the 52 table 
(1/5 the number of PPU words). 
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6000 SERIES PPU ABSOLUTE PROGRAM OR OVERLAY 

Binary output for a 6000 Series PPU program or overlay is a logical record that may contain the following: 

A prefix table (Optionally suppressed through NOLABEL) 

A 6000 Series PPU program control table (Optionally suppressed through NOLABEL) 
An absolute image of all text generated since previous IDENT or SEGMENT pseudo instruction. 
PPU text is generated 5 PPU words per 60-bit CPU word. 



The format of the control table is as follows: 
59 42 36 



24 



12 



00 



name 


00 | fwa 


0000 


length 



Bits 



Field 



59-42 name 
41-36 none 
35-24 fwa 



23-12 
11-00 



none 
length 



Description 

Program name, 1-3 display code characters, left justified with zero fill. 

Reserved for future system use. 

Origin -5 as specified on IDENT or SEGMENT pseudo instruction; at which table 
is loaded 

Reserved for future system use. 

Number of CPU words in program image (1/5 the number of PPU words) 



SYSTEM TEXT (SYSTEXT) 

Normally, system text is derived from the library overlay named SYSTEXT f and is assembled prior to 
assembly of the source program. However, the source of system text can be changed through the S 
option on the COMPASS card (section 10. 1. 2). A system text overlay on the library is an absolute 
overlay that has the following control table: 



59 



48 



42 



36 



|V2TEXT for SCOPE 2. 



00 



5000 


01 


01 


000000000000 
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Format of Text: 







System Symbol 

Table 

2 words per entry 



► Micro Definitions 



> Macro/ opdef definitions 



Operation Table 

Entries 

2 words per entry 



l.= Number of words in each part of record. 



COMPASS produces a systems text record as a result of encountering an STEXT pseudo instruction 
during assembly. If the rname is blank no binary is generated. If rname is nonblank, both the binary 
and the systems text are generated. 

The System Symbol Table does not include the following symbols: 

Local symbols 

Qualified symbols 

SET-defined symbols 

Relocatable symbols (not in the absolute block) 

External text symbols, that is, library input symbols and symbols read from XTEXT or 
occurring between CTEXT and ENDX 

SST-defined symbols 
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COMPRESSED COMPILE FILE 

Source statement input for COMPASS assembly can be in the form of a 6000/7000 UPDATE or a 
7600 MODIFY t created compressed compile file. 

A compressed compile file record written by MODIFY t in A mode has the following format: 



59 54 48 42 36 



18 



00 



Y///////////////77777X 



77 



00 00 



16 



modname-, 



sequence no.. 




modname r 



sequence no. 2 




modname„ 



sequence no. 




modnamei 



sequence no. ■ 
compressed card 



1-7 character name identifying latest modification for the card. 

Sequence number of the card relative to the modification set identified by modname. 

A COMPASS source card in compressed form. That is, two or more consecutive 
blanks (to a maximum of 64) are replaced by a byte of the form 0001 through 
0077„. A single blank is represented in display code (55g). If the source card 
contains 65 consecutive blanks, the 65 th is represented by a display code 
blank (55g). 66 or more successive blanks are represented by 0001, etc. 
A zero byte (0000) signifies an end of line (EOL). 



f MODIFY is not supported by SCOPE 2. 
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A compressed compile file record written by UPDATE in X mode is in the following format: 



ciQ Fi/L a« 42 



'i It v//////////?/////////y)X 



77 00 00 



sequence field^ 



nwj 




sequence field 




sequence field. 



compressed cardj 



17 characters comprising card columns 74-90 (column 73 is always blank). 

Binary number of words in compressed card . 

i 

Columns 1-72 of a COMPASS source card in compressed form. That is, 

each 00 character is replaced by the 12-bit value 0001, and three or more 

consecutive blanks (to a maximum of 64) are replaced by a 12-bit value 

0002 through 0077 g . A single blank is represented in display code (55g); 

two consecutive blanks are represented by the 12-bit value 5555 s . If the 

last word is not full, it is padded on the right with binary zeros. Because 

word count nwj is present, an extra all-zero is not required to guarantee 

12 zero bits. 
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BINARY CARD FORMATS 



Column 1 



7,8,9 

6,7,9 

6,7,8,9 

7,9 

7 and 9 not both in column 1 



End of logical record 
End of file 
End of information 
Binary card 
Coded card 





1 


2 


3 


4 


5 


















1?, 


/ 

CI 
3 
O 

U 

U 
O 

m 

*«*»*■*« 

TTVT- 


o 
o 

o 

s 

o 

u 












^ 








T3 

to 




11 












s. 






o 




































1 


















2 


















3 










"s 


L 




T1 

to 
§ 


4 
















o 
a 

0) 


5 
















6 
















7 


















8 










■^ 


^ 






9 























A binary card can contain up to 15 60-bit CPU words starting at column 3. Column 1 also contains 
a count of 60-bit words in rows 0, 1, 2 and 3 plus a check indicator in row 4. If row 4 of column 1 is 
zero, column 2 is used as a checksum for the card on input; if row 4 is one, no check is performed on 
input. 

Column 78 of a binary card is not used, and columns 79 and 80 contain, a binary serial number. If 
a logical record is punched, each card has a checksum in column 2 and a serial number in columns 79 
and 80, which sequences it within the logical record. 

Coded cards are translated on input from Hollerith to display code, and packed 10 columns per CPU 
word. A CPU word with a lowest byte of zero marks the end of a coded card (it is a coded record), and 
the full length of the card is not stored if it has trailing blanks. A compact form is thereby produced 
if coded cards are transferred to another device. 
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CHARACTER SETS 



NOTES 

1. The terms upper case and lower case apply only to the case conversions, and do 
not necessarily reflect any true case. 

2. When translating from display code to ASCII/EBCDIC the upper case equivalent 
character is taken. 

3. When translating from ASCII/EBCDIC to display code, the upper case and lower 
case characters fold together to a single display code equivalent character. 

4. All ASCII and EBCDIC codes not listed are translated to display code 55 (space). 

5. Where two display code graphics are shown for a single octal code, the leftmost 
graphic corresponds to the CDC 64-character set (system assembled with IP. CSET 
set to C64.2), and the rightmost graphic corresponds to the CDC 64 character 
ASCII subset (system assembled with IP CSET set to C64.2). 

6. In a 63-character set system, the display code for the : graphic is 63. The % 

character does not exist, and translations from ASCII/EBCDIC % or ENQ yield 

blank (55 ). The display code value 00 is undefined in 63-character set systems. 
8 

7. Twelve or more zero bits at the end of a 60-bit word are interpreted as an 
end-of-line mark rather than two colons. An end-of-line mark is converted to 
external BCD 1632 and internal BCD 1672 by operating systems when writing 
7-track magnetic tape in even parity (coded) mode, and converted back to 0000 
when reading. 

8. This code is changed to 12 when written on a 7-track magnetic tape in even 
parity (coded) mode. 

9. 11-0 and 11-8-2 are equivalent on input. The character will be punched as 
11-0 on output. 

10. 12-0 and 12-8-2 are equivalent on input. The character will be punched as 
12-0 on output. 

11. 12-8-7 and 11-0 are equivalent on input. The character will be punched as 
12-8-7 on output. 

12. 12-8-4 and 12-0 are equivalent on input. The character will be punched as 
12-8-4 on output. 

13. CODE pseudo selects 6-bit octal code as follows: 



A 


ASCII 


D 


Display Code (default) 


E 


External BCD 


I 


Internal BCD 
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CODE D (default) 
T 



CODE E 






CODE I 



CODE A 
I 



Disp 
Coc 

Octal 
© 


ay 
le 

Char. 


Hollerith 
Punch 
(026) 


B( 
Ext. 


3D 

Int. 
© 


6-Bit 
Octal 

® 


Upp 
Hex. 


er Case 
Char. 


AS 

Punch 
(029) 


211 

Hex. 


Lower 
Char. 


Case 
Punch 


Upp 
Hex. 


EBCI 
er 

Char. 


)IC 

Low 

Hex. 


er 
Char. 


00 





8-2 


oo® 


12 


32 


3A 




8-2 


1A 


SUB 


9-8-7 


7A 




3F 


SUB 


01 


A 


12-1 


61 


21 


41 


41 


A 


12-1 


61 


a 


12-0-1 


CI 


A 


81 


a 


02 


B 


12-2 


62 


22 


42 


42 


B 


12-2 


62 


b 


12-0-2 


C2 


B 


82 


b 


03 


C 


12-3 


63 


23 


43 


43 


C 


12-3 


63 


c 


12-0-3 


C3 


C 


83 


c 


04 


D 


12-4 


64 


24 


44 


44 


D 


12-4 


64 


d 


12-0-4 


C4 


D 


84 


d 


05 


E 


12-5 


65 


25 


45 


45 


E 


12-5 


65 


e 


12-0-5 


C5 


E 


85 


e 


06 


F 


12-6 


66 


26 


46 


46 


F 


12-6 


66 


f 


12-0-6 


C6 


F 


86 


f 


07 


G 


12-7 


67 


27 


47 


47 


G 


12-7 


67 


e 


12-0-7 


C7 


G 


87 


g 


10 


H 


12-8 


70 


30 


50 


48 


H 


12-8 


68 


h 


12-0-8 


C8 


H 


88 


h 


11 


I 


12-9 


71 


31 


51 


49 


I 


12-9 


69 


i 


12-0-9 


C9 


I 


89 


i 


12 


J 


11-1 


41 


41 


52 


4A 


J 


11-1 


6A 


J 


12-11-1 


Dl 


J 


91 


J 


13 


K 


11-2 


42 


42 


53 


4B 


K 


11-2 


6B 


k 


12-11-2 


D2 


K 


92 


k 


14 


L 


11-3 


43 


43 


54 


4C 


L 


11-3 


6C 


1 


12-11-3 


D3 


L 


93 


1 


15 


M 


11-4 


44 


44 


55 


4D 


M 


11-4 


6D 


m 


12-11-4 


D4 


M 


94 


m 


16 


N 


11-5 


45 


45 


56 


4E 


N 


11-5 


6E 


n 


12-11-5 


D5 


N 


95 


n 


17 


O 


11-6 


46 


46 


57 


4F 


O 


11-6 


6F 


o 


12-11-6 


D6 


O 


96 


o 


20 


P 


11-7 


47 


47 


60 


50 


P 


11-7 


70 


P 


12-11-7 


D7 


P 


97 


P 


21 


Q 


11-8 


50 


50 


61 


51 


Q 


11-8 


71 


q 


12-11-8 


D8 


Q 


98 


q 


22 


R 


11-9 


51 


51 


62 


52 


R 


11-9 


72 


r 


12-11-9 


D9 


R 


99 


r 


23 


S 


0-2 


22 


62 


63 


53 


S 


0-2 


73 


s 


11-0-2 


E2 


S 


A2 


s 


24 


T 


0-3 


23 


63 


64 


54 


T 


0-3 


74 


t 


11-0-3 


E3 


T 


A3 


t 


25 


U 


0-4 


24 


64 


65 


55 


U 


0-4 


75 


u 


11-0-4 


E4 


U 


A4 


u 


26 


V 


0-5 


25 


65 


66 


56 


V 


0-5 


76 


V 


11-0-5 


E5 


V 


A5 


V 


27 


w 


0-6 


26 


66 


67 


57 


w 


0-6 


77 


w 


11-0-6 


E6 


W 


A6 


w 


30 


X 


0-7 


27 


67 


70 


58 


X 


0-7 


78 


X 


11-0-7 


E7 


X 


A7 


X 


31 


Y 


0-8 


30 


70 


71 


59 


Y 


0-8 


79 


y 


11-0-8 


E8 


Y 


A8 


y 


32 


Z 


0-9 


31 


71 


72 


5A 


z 


0-9 


7A 


z 


11-0-9 


E9 


z 


A9 


z 


33 








12 


00 


20 


30 








10 


DLE 


12-11-9-8-1 


F0 





10 


DLE 


34 


1 


1 


01 


01 


21 


31 


1 


1 


11 


DC1 


11-9-1 


Fl 


1 


11 


DC1 


35 


2 


2 


02 


02 


22 


32 


2 


2 


12 


DC2 


11-9-2 


F2 


2 


12 


DC2 


36 


3 


3 


03 


03 


23 


33 


3 


3 


13 


DC3 


11-9-3 


F3 


3 


13 


TM 


37 


4 


4 


04 


04 


24 


34 


4 


4 


14 


DC4 


11-9-4 


F4 


4 


3C 


DC4 



D-2 
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CODE D (default) 



CODE E 



I t 



CODE I 



CODE A 
t 



Display 


Hollerith 


BCD 








ASCII 










EBCDIC 




Code 


Punch 








Upper Case 




Lower Case 


Upper 


Lower 






(026) 






6-Bit 






















Octal 


Char. 
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13 
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Char. 
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Hex. 


Char. 
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Hex. 


Char. 
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Char. 


40 
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05 


05 


25 


35 
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5 


15 


NAK 


9-8-5 


F5 


5 


3D 


NAK 


41 
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6 


06 


06 


26 


36 


6 


6 


16 


SYN 


9-2 


F6 


6 


32 


SYN 


42 


7 
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07 


07 


27 


37 
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17 


ETB 
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F7 


7 


26 


ETB 


43 
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30 


38 
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18 
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11-9-8 


F8 


8 


18 


CAN 


44 


9 


9 


11 


11 


31 


39 
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19 


EM 


11-9-8-1 


F9 
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19 


EM 


45 
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12 


60 


20 


13 
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12-8-6 
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VT 


12-9-8-3 


4E 


+ 


0B 


VT 
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11 


40 
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15 


2D 
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11 
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CR 


12-9-8-5 


60 
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CR 
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* 


11-8-4 


54 


54 


12 


2A 


* 


11-8-4 


0A 


LF 


0-9-5 


5C 


* 


25 


LF 


50 


/ 


0-1 


21 


61 


17 


2F 
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0-1 


OF 


SI 


12-9-8-7 


61 


/ 


OF 


SI 


51 


( 


0-8-4 


34 


74 


10 
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12-8-5 


08 


BS 


11-9-6 


4D 
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16 


BS 
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) 


12-8-4 


74 


34 


11 


29 


) 


11-8-5 


09 


HT 


12-9-5 


5D 


) 


05 


HT 


53 


$ 


11-8-3 


53 


53 


04 


24 


$ 


11-8-3 


04 


EOT 


9-7 


5B 


$ 


37 


EOT 


54 


= 


8-3 


13 


13 


35 


3D 


= 


8-6 


ID 


GS 


11-9-8-5 


7E 


= 


ID 


IGS 


55 


space 


space 


20 


60 


00 


20 


space 


space 


00 


NUL 


12-0-9-8-1 


40 


space 


00 


NUL 


56 


f 


0-8-3 


33 


73 
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2C 


* 
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OC 


FF 
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6B 
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0C 


FF 
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0E 
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SO 
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ETX 


12-9-3 
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61 


[ 


8-7 


17 


17 
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5B 


t 


12-8-2 


1C 


FS 
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4A 
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1C 
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62 


%© 


0-8-2 


32 


72 


75 


5D 
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01 
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5A 
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HINTS ON USING COMPASS 



1. Within a macro definition: 

a. Use comment cards having * in column one. These are not saved whereas other types of 
comments are saved. 

b. Whenever possible minimize the number of lines of code. 

c. IRP is faster than either ECHO or DUP. 

d. Use the substitutable parameter flags ;A, ;B, etc. , for macros to avoid a second line. 

e. Within macros , use symbols such as .1, .2, etc. instead of local symbols. 

f. If possible, avoid recursive macro structure to increase assembly speed. 

g. If a macro call is the cause of an error, direct full list output to a file other than OUTPUT 
(L=filename) to obtain a list of the erroneous macro call with the error listing. 

2. In IF sequences: 

a. Use line counts rather than ENDIF to terminate sequences. 

b. Use SKIP rather than IFPP to skip code. 

3. Micros: 

a. Micro replacement is time consuming. 

b. Avoid using local symbols for micros. 

c. Use ^ ^ for a null substitution. 

4. Minimize SYSTEXT size. 

5. To reduce core requirements, use SEG cards in absolute programs. 

6. Use NOREF for symbols for which listing is not required. 

7. Use QUAL for all overlays. 
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DAYFILE MESSAGES 



nERRORS IN name 

COMPASS issues this message for each source program in which fatal errors are detected. 

nnnnnnB LCM NEEDED TO CONTINUE. 

During initialization, the 7600 COMPASS Version 2 assembler estimates the number of LCM words 
required to begin processing. If the estimated number (in octal) is less than the job's LCM field 
length and if the job is in user controlled FLL mode, this message is issued and the job aborted. 

nLOST REFERENCES IN name 

COMPASS issues this message for each source program whose symbolic cross-reference table does 
not fit in the job's CMf field length for sorting just before it is printed. Rather than aborting the job, 
COMPASS discards some of the references. The ASSEMBLY COMPLETE message gives the field 
length needed to avoid lost references. 

nnnnnnB S C M NEEDED TO CONTINUE. 

During initialization, the 7600 COMPASS Version 2 assembler estimates the number of SCM words 
required to begin processing. If the estimated number (in octal) is less than the job's SCM field 
length and if the job is in user controlled FLS mode, this message is issued and the job aborted. 

nWARNING MESSAGES IN name 

COMPASS issues this message for each source program in which non-fatal errors are detected. 

ASSEMBLING name 

This message is displayed at the system operator's console only. It is not written in the dayfile. 
COMPASS updates the display whenever it processes an IDENT statement with a non-blank variable 
field. 

ASSEMBLY COMPLETE. nB SCMffUSED. 

COMPASS issues this message when it has completed processing of all source programs on the input 
file without having detected any fatal errors, n is the octal number of SCM words needed. For instance, 
the minimum field length needed to perform the assemblies successfully. It may be larger than the 
actual field length, in which case, it is the minimum field length needed to avoid lost references. 



"fLCM for the 7600 COMPASS Version 2 assembler. 

ttFor the 7600 COMPASS Version 2 assembler, SCM is replaced by LCM and is the octal number of 
LCM words required for the internal tables maintained in LCM. 
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ASSEMBLY ERRORS. nB SCMj USED. 

COMPASS issues this message when it has completed processing of all source programs on the input 
file and detected at least one fatal error. If the A option was specified on the COMPASS control card, 
COMPASS aborts the job after issuing this message, n is the same as in the ASSEMBLY COMPLETE 
message. 

BAD SYSTEMS TEXT. 

The system text overlay does not have the internal format required by this version of COMPASS. This 
may be caused by a system error. COMPASS ignores the overlay but does not abort the job. 

CANT LOAD COMPl$ 

The operating system loader reported a fatal error when COMPASS attempted to load its primary 
overlay. This message should be preceded by an explanatory message from the loader. 

ERROR IN COMPASS ARGUMENTS. 

The COMPASS control card contains an unrecognized or invalid argument. The job is aborted. 

IDENT CARD MISSING. 

COMPASS issues this message for each source program in which an END statement is encountered 
before an IDENT statement. This is a fatal error. 

INPUT FILE EMPTY OR MISPOSITIONED. 

COMPASS encountered end of data when it attempted to read the first line from the source input file. 
After issuing this message, COMPASS generates an END card which causes the EDENT CARD MISSING 
message and a fatal error. This message is issued by 7600 COMPASS Version 2 only. 

INSUFFICIENT STORAGE FOR SYSTEMS TEXT. 

COMPASS issues this message and aborts the job when an irrecoverable table overflow occurs during 
system text loading, before the first assembly is begun. For 6000 COMPASS Version 2 and 7600 
COMPASS Version 1, a substantial increase in the job's CM/SCM field length may be needed. The 
message is also issued if system text specified by the G option is of such length that it cannot be read 
into the job's field length. In this case, the job is not aborted but the system text is ignored. For the 
7600 COMPASS Version 2 assembler, an increase may be needed for either LCM or SCM if the job 
is in user controlled FL mode. This message will be followed by MORE SCM NEEDED, or MORE 
LCM NEEDED. 



tFor the 7600 COMPASS Version 2 assembler, SCM is replaced by LCM and n is the octal number 
of LCM words required for the internal tables maintained in LCM. 
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INSUFFICIENT STORAGE. JOB ABORTED. 

The job's CM field length is too small for COMPASS to begin processing. This message is issued not 
issued by 7600 COMPASS Version 2. 

MORE L C M NEEDED. 

This message is issued by the 7600 COMPASS Version 2 assembler after a message concerning table 
overflow has been issued in order to emphasize that the internal tables require LCM. 

NO SYSTEM TEXT FOUND. 

COMPASS issues this message, but does not abort the job, when it cannot load the system text specified 
on the COMPASS control card. For an overlay loaded from a library (S parameter), this message 
should be preceded by an explanatory message from the operating system loader. For an overlay 
loaded from non-library file (G parameter), COMPASS cannot find the overlay on the file. 

RECURSION DEPTH EXCEEDED 400. 

COMPASS maintains a push-down stack for source input control, with one entry for each active DUP, 
ECHO, HERE, XTEXT, OPDEF, or macro call. The maximum depth of this stack is set by an installa- 
tion parameter, 400 in the released system. When this limit is exceeded, COMPASS sets a fatal error 
and clears the stack so that the next statement will be read from the source input file, but does not 
abort the job. This error is usually caused by a source program error in which a macro calls itself 
indefinitely. 

TABLE OVERFLOW IN PASS n. 

An irrecoverable table overflow condition has occurred in assembly pass 1 or 2 while processing a 
source program. COMPASS allocates memory space dynamically to all of its internal tables, so that 
when one overflows, all do. When the tables do not all fit in the available CMf space, COMPASS 
stores some of them on mass storage scratch files. 

COMPASS issues the above message, and aborts the job, when CMf is insufficient after all such files 
have been written to mass storage. 



fLCM for the 7600 COMPASS Version 2 assembler. 
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INDEX 



A code option 4-22 

A error 11-10 

A list option 4-G6 

A reference table option 4-73 

A register 

description 8-8 

designators 2-8 

setting 8-44 
ABS attribute 4-59 
ABS pseudo 

description 4-6 

example 4-4,7,8,12,13,15,41 

first statement group 4-2 
Absolute block 

absolute program 3-7 

description 3-2 

establishment 4-28 

relocatable program 3-5 

using 4-26,28 
Absolute program 

declaration 4-6 

structure 3-7 
Absolute text 3-5, B-5 
ACN instruction 9-22 
ADC instruction 

arithmetic function 9-4 

description 9-9 

example 2-21,9-9 
ADD instruction 

arithmetic function 9-4 

description 9-13 
Add unit 

floatingpoint 8-3,31 

long 8-3 
Address modes, PPU 9-1 
Address 

absolute 4-4 

direct 9-13 

entry point 4-4,5,41; B-4,11,12 

external 4-6,7,8,42; B-9 

indexed 9-15 

indirect 9-14 

relocatable 4-5 



ADI instruction 

arithmetic function 9-4 

description 9-14 
ADM instruction 

arithmetic function 9-4 

description 9-15 
ADN instruction 

arithmetic function 9-4 

description 9-8 
AJM instruction 9-17 
AOD instruction 

description 9-13 

replace function 9-5 
AOI instruction 

description 9-14 

replace function 9-5 
AOM instruction 

description 9-15 

replace function 9-5 
Arithmetic functions, PPU 9-4 
Arithmetic shift 8-31,33 
Arrow 

parameter separator 5-8,13 

special character 2-4 
Assembler 1-1 

core requirements 1-3; 10-2 

statistics 4-66; 11-9 
Assembly environment test 4-56 
Assembly listing 

detailed description 11-1 

general description 4-66 

generation 1-3 
Assembly, remote code 5-3 
Assembly time 11-9 
Asterisk 

BASE instruction 4-26 

element operator 2-22 

first column 2-1,2 

local symbol separator 5-32 

location counter 2-9. 22 

parameter separator 5-8,13,16,25,28 

special element 2-9,22 

USE instruction 4-20 

USELCM instruction 4-28 
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Attribute, symbol 2-6 
Attribute test 4-58 
AXi instruction 8-31,33 

Bbase 2-17,18; 4-20 

D binary mode 10-3 

B list option 4-67 

B reference table option 4-73 

B register 

conditional jumps 8-25 

contents of Bl, B7 4-25 

description 8-4 

designators 2-8 

setting 8-46 
Bl 1 or B7 1 pseudo instruction 

description 4-25 

effect on R 4-51 

example 4-52 

illegal for PPU 4-7,8 
Base, assembly 4-19 

COL column count 4-25 

DIS word count 4-45 

Dl'P count 5-6 

KCHO count 5-7 

line count 4-56,57,59,61,63 

micro count 7-2,4,5 

numeric value 2-17 

overlay level numbers 4-4 

PPU number 4-4 

RKPI counts 4-53 

setting through BASE 4-20 

SPACE line count 4-69 

string count 2-13 

VFI) count 4-49 
BASE pseudo 

description 4-19 

example 4-12,17,21,45,47 

permissible anywhere 4-2 
Binary control statements 4-67 ; 11-1 
Binary format 

absolute B-ll 

card C-l 

loader tables B-l 

overlay B-ll 

PPU, 6000 B-13 

PPU, 7600 B-12 

relocatable B-l 

systems text 4-17, B-13 
Binary mode 10-3 

Binary output generation 1-3; 3-7,10,12,14; 10-3 
Binary write 3-7 
Blank 

compressed 5-1 



embedded 2-1 
expression terminator 2-22 
name terminator 2-5 
operation field 2-1 
parameter separator 5-8,13 
statement terminator 2-1 
string terminator 2-13 
use in character data 2-13 
variable field 2-2,4; 3-7 
Blank card 4-69 
Blank common 

description 3-3 
establishment 4-26 
example 4-31 
LCM 4-28 
SCM 4-26 
Blank fill 2-14 

DIS 4-45 
Blank operation field 4-43 
Block copy instruction 8-14 
Block group 3-1,10,12,14,15 
Block group listing 11-3 
Blocks 

absolute 3-2; 4-26,29 
blank common 3-3; 4-26,28 
labeled common 3-2; 4-26 
literals 2-11; 3-2,6,7,10,12,14,15 
local 3-2; 4-26 
maximum number 3-1; 4-26 
origin assigned 1-3; 3-5,7 
subprogram 3-1 

used for definition operation 5-2 
user established 3-2; 4-26,28 
zero 3-2, 4-26,28 
Block name 4-26 
Block name listed 11-1 
Block origin 1-3; 3-5 
Block usage summary 11-3 
Boolean unit 

description 8-4,7 
instructions 8-27,28,29,30,35,36 
Branch instructions 

CPU 8-11,13,16,23,24,25 
PPU 9-5 
Branch unit 

description 8-4 

instructions 8-11,13,16,23,24,25 
BSS pseudo 

description 4-31 
effect on origin counter 3-3 
example 4-4,8,15,24,30,31; 5-22,33 
force upper 3-5 
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BSSZ pseudo 

description 4-43 

dumped by SEGMENT 4-14 

example 2-19; 5-34,36 

force upper 3-5 

REPL table B-8 
BXi instruction 8-27,28,29,30 
Byte 

control B-7 

data B-7 

guaranteed zero 2-14; 4-45 

C list option 4-67 

C on octal listing 11-7 

Call 

equivalenced macro 5-25 

macro 5-18 

opdef 5-30 
Central processor unit 

execution times A-l 

functional units 8-4,7 

instructions 8-1 

registers 8-8 
Channel buffer instruction 

read status 8-22 

reset input 8-19 

reset output 8-21 
Character codes D-l 
Character data 2-13 

code conversion 4-21 

evaluation 2-26 

examples 2-11,15 
Code 

CPU operation 6-7; 8-1 

duplication 5-6 

PPU operation 6-3; 9-1 

remote assembly 5-3 

replication 4-53 
CODE pseudo 

description 4-21 

effect on character data 2-13; 4-45 

example 4-22 

permissible anywhere 4-2 
Coding form 2-3 
COL pseudo 

description 4-25 

octal listing 11-7 
Column one 2-1 
COM attribute 4-59 



Comma 

character string 2-13 

column one 2-1 

continuation 2-1 

expression terminator 2-22 

local symbol separator 5-32 

name terminator 2-5 

parameter separator 5-8,13,16,25,28 

string terminator 2-22 

subfield delimiter 2-1 
COMMENT pseudo 

description 4-18 

example 4-12 

first statement group 4-2 
Comments column control 4-25 
Comments field 2-2,3; 4-25 
Comments statement 2-2 

heading of definition 5-13 

micros not substituted 7-1 

not counted 4-55; 5-7,8 

permissible anywhere 4-2 
Comments, prefix table 4-18 
Compare character strings 4-61 
Compare expression values 4-57 
COMPASS call card 

description 10-2 

effect on LIST 4-65 
Compile file 10-3, B-15 
Comp and log difference instruction 8-30 
Comp and log sum instruction 8-30 
Complement instruction 8-29 

Compressed code 5-1; B-15 
CON pseudo 

description 4-50 

example 2-21; 4-51; 5-6,23, 27 

force upper 3-5 
Concatenation 2-4 
Concatenation mark 2-4 

example of use 5-19 

in definition 5-1 
Conditional assembly 4-55 
Conditional jump 

B register 8-25 

PPU 9-7 

X register 8-23 
Configuration 1-3 
Constant 

character 2-13 
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description 2-10 

expression element 2-22,26 

field size 2-10 

generated by pseudo 4-50 

numeric 2-17 

read only 2-11 
Continuation, statement 2-2 

generation of lines 2-4; 7-1 
Control cards 

COMPASS 10-2 

end of information 10-6 

end of record 10-5 

job card 10-1 

SCOPE cards 10-1 
Core requirements 1-3; 10-2 
Counters, block control 3-3,10,12 
Counter control 

BSS 4-31 

forcing upper 3-4 

LOC 4-32 

ORG 4-29 

POS 4-34 

USE 4-26 

USELCM 4-28 
CPOP pseudo 6-7 
CPSYN pseudo 

description 6-9 

permissible anywhere 4-2 
CPU instructions 

block copy 8~14 

Boolean 8-27,28,29,30,31 

branching 8-23,25 

channel buffer 8-19,21 

channel status 8-22 

complement 8-29 

conditional 8-23,25 

direct LCM transfer 8-18 

divide 8-42 

double precision 8-37,40 

ECS 8-14 

error exit 8-12 

exchange exit 8-17 

exchange jump, 6000 8-16 

execution times A-l 

fixed point 8-38 

floatingpoint 8-37,38,39,40,42,43 

increment 8-44,46,47 

left shift 8-31,32 

logical 8-27,28,29,30,31 

long add 8-38 

mask 8-41 

multiply 8-39,40 

no operation 8-43 



normalize 33,34 

pack 8-36 

pass 8-43 

population 8-43 

program stop, 6000 8-11 

real time clock 8-20 

return jump 8-13 

right shift 8-31,33 

set register 8-44,46,47 

set time 8-20 

shift 8-31,32,33 

single precision 8-36,38,39,40,42 

transmit 8-27 

unconditional jump 8-23 

unpack 8-35 
CPU program execution 1-3; 10-1 
CPU register designators 2-8; 8-8 
CRD instruction 9-17 
Created symbol 5-33, 11-9 
CRM instruction 9-17 
Cross reference table 

(see symbolic reference table) 
CTEXT pseudo 4-72 
CWD instruction 9-17 
CWM instruction 9-17 
CXi instruction 8-43 

Dbase 2-17,18; 4-20 
D code option 4-22 
D debug mode 10-3 
D definition flag 11-14 
D error 11-10 
D list option 4-67 
Data generation 4-43 
Data item 

character format 2-13 

DATA pseudo 4-44 

general description 2-10 

LIT pseudo 4-47 

numeric format 2-17 

VFD pseudo 4-49 
Data notation 

character 2-13 

constant 2-10,13,17 

decimal 2-17 

element 2-10,22 

fixed point 2-17 

floating point 2-17 

item 2-10,13,17 

literal 2-11,13,17 

numeric 2-17 

octal 2-17 
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DATA pseudo 

description 4-44 

example 2-15,19,20; 4-22,27,30,44 

force upper 3-5 
Data transmission, PPV 9-3 
DATE micro 7-5 
Date of listing 11-1 
DCN instruction 9-22 
Debug mode 10-3 
Decimal exponent 2-18 
Decimal notation 2-17 
DECIUIC pseudo 

description 7-4 

example 5-6; 7-4 

permissible anywhere 4-2 
DEF attribute 4- GO 
lie fault symbols 

definition 2-7 

listing 11-9 

unqualified 4-22 

zero block 3-2 
Deferred symbols 

(see default symbols) 
Definition 

equivalenced macro 5-24 

macro 5-13,15,24 

micro 7-2 

opdef 5-13,27 

processing 5-13 

purging 6-9 

reference 5-18,25,30 

symbol 2-6; 4-34 

system 5-36 
Definition operation 

duplicated code 5-6 

equivalenced macro 5-13 

external text 5-2 

macro 5-13 

operation code 5-13 

processing 5-14 

recursion level 5-1 

remote text 5-3 
Delimiter 

actual parameter 5-18,26 

data item 2-13,17 

expression element 2-22 

field 2-1,2 

substitutable parameter 5-8,13,16 

term 2-22 
Descriptor, variable field 5-27; 6-7 



Destination field 2-26 
Detailed listing 4-67; 11-1 
DF instruction 8-24 
Direct address 9-13 
Directives, loader 4-17 
Directory, error, 11-9 
DIS pseudo 

description 4-45 

example 4-45,46 

force upper 3-5 
Display code option 

character set D-l 

default mode 2-13 

option 4-22 
Divide instructions 8-42 
Dollar sign 

local symbol separator 5-32 

parameter separator 5-8, 13,16, 25, 28 

special element 2-6 
Double precision Instructions 8-37,40 
DUP pseudo 

description 5-6 

example 5-10,11 

listing of count 11-7 
Duplicate symbol 

definition 2-6 

flag 11-14 
Duplication 

code 5-6 

echoed 5-7 

indefinite 5-7,9 
DXi instructions 

add 8-37 

multiply 8-40 

E code option 4-22 

E entry point flag 11-14 

E error 11-10 

E list option 4-67 

E numeric data modifier 2-18 

ECHO pseudo 

description 5-7 

example 5-12 
ECS blocks 4-28 
Editing 2-4 

EE numeric data modifier 2-18 
EIM instruction 9-18 
EJECT pseudo 4-69 

permissible anywhere 4-2 
Eject suppression 10-4 
EJM instruction 9-17 
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Element 

absolute 2-23 

data 2-10,11 

expression 2-22,26 

external 2-25 

operator 2-22 

register 2-25 

relocatable 2-9,24 

special 2-9 
ELSE pseudo 

description 4-56 

example 5-5 

permissible anywhere 4-2 

END pseudo 

assembly of remote code 5-3 

binary generation 3-7 

description 4-5 

effect on blocks 3-1,7,10,14,15 

example 4-4,5,14,65 

external text use 5-3 

force upper 3-5 

illegal definitions 5-1 

permissible anywhere 4-2 
ENDD pseudo 

acting as nil 6-6 

description 5-10 

example 5-11 

permissible anywhere 4-2 

used with DUP 5-7 

used with ECHO 5-8 
ENDIF pseudo 

acting as nil 6-6 

description 4-55 

permissible anywhere 4-2 
ENDM pseudo 

acting as nil 6-6 

description 5-14 

example 4-24; 5-11,15,19,20,21,22,23,27, 
30,31,32,33,35,36 

permissible anywhere 4-2 
End-of-information card 10-6 
End-of-line mark 5-1 
End-of-record 

card 4-2; 10-5 

external text 5-3 
ENDX pseudo 4-72 
ENTR table B-4 
Entry address 

absolute 4-4 

declaration 4-41 

multiple 3-14; B-12 

relocatable 4-5 

table B-4, 11, 12 



ENTRY pseudo 

description 4-41 

example 4-5,41 
Entry point list 11-4 
Entry point table 

absolute B-11,12 

relocatable B-4 
Environment test 4-56 
EOM instruction 9-18 
EQ instruction 

description 8-25 

example 8-26 

force upper 3-5 
EQ IF operator 4-57 

IFC operator 4-61 
EQU pseudo 

description 4-35 

example 2-19,21; 4-17,24,35,36,54; 5-6 

listing 11-7 
Equal sign 

default symbol prefix 2-7 

instruction 4-35 

literals prefix 2-11,13,19 

local symbol separator 5-32 

parameter separator 5-8, 13, 16, 25, 28 
ERN instruction 9-12 
ERR pseudo 

description 4-63 
Error, assembly 

fatal 11-14 

informative 11-15 

programmer controlled 4-63 
Error directory 

detailed description 11-9 

general description 4-66 
Error exit instruction 8-12 
Error flags 

conditionally set 4-64 

fatal 11-10 

informative 11-12 

unconditionally set 4-63 

where on listing 11-6 
ERRxx pseudo 4-64 
ES instruction 8-12 
ESN instruction 9-23 
ETN instruction 9-12 
Evaluation of expression 2-26; 3-3 
Exchange exit instruction 8-17 
Exchange jump instruction 8-16 
Execution, CPU program 1-3 
EXN instruction 9-10 
Exponent 2-18 
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Expression 

absolute 2-23 

attribute 4-58 

comparison 4-57 

CON use 4-50 

description 2-22 

evaluation 2-23,26; 3-3 

examples 2-23,24,25 

external 2-25 

maximum size 2-26 

operators 2-22 

pass one value 2-26; 3-3 

pass two value 2-26; 3-3 

register 2-25; 8-2,10 

rules 2-22 

size 2-26 

types 2-23 

value 2-23,26; 3-3; 8-6 

VFD 4-49 
EXT attribute 4-59 
External BCD 

character set D-l 

option 4-22 
External reference table B-9 
External symbol 

declaration 4-42 

description 2-6,7 

relocatable table B-9 
External symbol list 11-5 
External text 

assembly 5-2 

file declaration 10-4 

listing 4-68 
EXT pseudo 

description 4-42 

illegal in absolute code 4-6,7,8 

F conditional flag 11-14 
F error 11-11 
F FORTRAN mode 10-3 
F list option 4-67 
FAN instruction 9-22 
Fatal error flag 11-10 
Features of COMPASS 1-2 
Field 

comments 2-2; 4-25 

conventional 2-3 

delimiter 2-1,2 

destination 2-26; 4-49 

free 2-1 

location 2-1 

operation 2-1 

size 2-1 



subfield 2-2 
terminator 2-1 
variable 2-2 
File 

COMPILE 10-3, B-15 
INPUT 10-3 
LGO 10-3 
list output 10-3 
load and go 10-3 
OPL 10-4 
OUTPUT 10-3,4 
source 10-3 
SYSTEXT 4-16; 10-3,4 
FILL table 

description B-6 
written by SEGMENT 4-14 
Fill, blank 2-14 
Fill common area table B-6 
Fill, zero 2-14 
FIM instruction 9-18 
First column 2-1 
First statement group 4-2 
Fixed point data notation 2-17 
Fixed point instructions 8-38 
FJM instruction 9-17 
Flag, error 

listing 11-6 
setting 4-63 
type 11-14,15 
Floating point data notation 2-17 
Floating point units 8-4, 7 
add 8-37,38 
divide 8-42,43 
multiply 8-39,40 
FNC instruction 9-22 
FOM instruction 9-18 
Forcing upper 3-4 
BSS 4-31 

CPU instructions 8-2 
LOC 4-32 
macro call 5-19,26 
opdef call 5-31 
ORG 4-29 
R= 4-51 
USE 4-26 
USELCM 4-28 
VFD 4-49 
Form, COMPASS coding 2-3 
Format 

binary B-l 
control card 10-1 
CPU instruction 8-1 
line 2-1 
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listing 11-1 

PPU instruction 9-1 
FORTRAN 2-6; 4-4; 10-3 
Full list 10-3 
Functional units 8-4,7 
Functions, PPU 

arithmetic 9-4 

data transmission 9-3 

logical 9-4 

replace 9-5 
FXi instruction 

add 8-36 

divide 8-42 

multiply 8-39 

G assembly mode 10-3 
G list option 4-67 
GE instructions 8-25 
GE IF operator 4-57 

IFC operator 4-61 
Generated code listing 4-67 
Generation, data 4-44 
Get text mode 10-3 
GT instruction 8-25 
GT IF operator 4-57 

IFC operator 4-61 
Guaranteed zero 2-14; 4-46 

Hardware configuration 1-3 
Heading 

listing 4-66; 11-1 

macro 5-13 

opdef 5-13 

record B-11,12,13 
HERE pseudo 

description 5-4 

permissible anywhere 4-2 

I code option 4-22 
I input mode 10-3 
I NO LABEL option 4-19 
IAM instruction 9-21 
IAN instruction 9-20 
IBj instruction 8-22 
ID instruction 8-24 
IDENT pseudo 

binary generation 3-7,9 

blank variable field 3-15; 4-10 

block groupB 3-3 

description 4-2,9 



example 4-4,12,13,15,16,17,41 

force upper 3-5 

overlay generation 3-7,9 

program identification 4-2 
IF pseudo 4-57 
IF skipped lines listed 4-67 
IFC pseudo 

description 4-61 

example 5-5,11 

permissible anywhere 4-2 
IFCP pseudo 4-56 
IFop pseudo 4-57 
IFPP pseudo 4-56 
IJM instruction 9-17 
Increment unit 8-4,7,44,46,47 
Indexed address, PPU 9-15 
Index register 8-8 
Indirect address, PPU 9-14 
Input, assembler 10-2,3 
Instructions 

coding of 2-1 

CPU 8-1 

mnemonically identified 6-3 

nil 6-6 

no-operation 8-43; 9-9 

PPU 9-1 

pseudo 4-1 

redefinition 5-16,25 

synonymous 6-5,9 

syntactically identified 6-7 
Integer value 2-17 
Internal BCD 

character set D-l 

option 4-22 
Invented symbol 5-33; 11-9 
IR instruction 8-24 
IRM instruction 9-18 
IRP pseudo 

acting as nil 6-6 

description 5-34 

example 5-35,36 

permissible anywhere 4-2 
DCi instructions 8-38 

J option 4-7, 8; 9-5 
Job card 10-1 
Job priority 10-1 
JP instruction 

description 8-23 

force upper 3-5 
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L control card option 

description 10-3 

related to LIST 4-65 
L error 11-10 
L list option 4-67 
L location flag 4-32; 11-14 
Labeled common 

description 3-2 

establishment 4-26 

tables B-3 
LCC pseudo 

description 4-17 

illegal if absolute 4-6,7,8 
LCM attribute 4-59 
LCM blocks 3-3; 4-28 
LCM transfer instructions 8-14,18 
LCN instruction 

data transmission 9-3 

description 9-8 
LCT table B-3 
LDC instruction 

data transmission 9-3 

description 9-9 

example 2-21 
LDD instruction 

data transmission 9-3 

description 9-13 
LDI instruction 

data transmission 9-3 

description 9-14 
LDM instruction 

data transmission 9-3 

description 9-15 

example 5-21 
LDN instruction 

data transmission 9-3 

description 9-8 

example 5-12; 9-8 
Left shift instruction 8-31,32 
LE IF operator 4-57 

IFC operator 4-61 
LE instruction 8-25 
Library maintenance programs 2-1 

LINK table 

description B-9 

written by SEGMENT 4-14 
LGO control card 10-4 



Linkage symbols 2-7; 4-40; B-9 
Li stable output 

assembled code 11-6 

assembler statistics 11-9 

binary control cards 11-1 

block usage 11-3 

control card control 10-3,4 

default symbols 11-9 

entry point symbols 11-4 

error directory 11-9 

error flags 11-10,11 

external symbols 11-5 

header information 11-1 

literals 11-8 

source statements 11-6 

statistics 11-9 

subtitles 11-1 

symbolic reference table 11-13 

titles 11-1 

user control 4-65; 10-3,4 
List, full 10-3 
Listing control 

control card 10-3,4 

pseudo 4-65 
List, parameter 

ECHO 5-8 

equivalenced macro 5-25 

macro 5-18 
LIST pseudo 

description 4-65 

example 4-12;5-6,12 

permissible anywhere 4-2 
List, short 10-4 
Literals 

absolute program 3-8 

description of block 3-1,2 

IDENT 3-10,16 

listing 11-8 

location 1-3; 3rl,2- 

notation 2-11 

PPU overlay 3-12 
protection 4-29 
SEGMENT overlay 3-16 
SEG partial binary 3-14 
symbol 2-7 
LIT pseudo 

description 4-47 

example 2-11,16,20; 4-13,48; 5-6 
listing 11-7,8 
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LJM instruction 

description 9-6 

example 5-21 
LMC instruction 

description 9-9 

logical function 9-5 
LMD instruction 

description 9-13 

logical function 9-5 
LMI instruction 

description 9-14 

logical function 9-5 
LMM instruction 

description 9-15 

logical function 9-5 
LMN instruction 

description 9-8 

logical function 9-5 
Load address 4-3 
Load-and-go file 1-3; 10-3 
Loader control card 4-17 
Loader tables B-l 
LOC attribute 4-59 
Local blocks 3-2 

absolute program 3-7 

description 3-2 

establishment 4-26 

relocatable program 3-5 
Local common table B-3 
LOCAL statement 

description 5-32 

example 5-33 

heading 5-13 
Local symbol 

CPU instruction 8-5 

macro body 5-13 

subprogram 3-1; 4-22 
Location counter 

BSS 4-31 

control 4-26 

description 3-4 

forced upper 3-5 

ORG 4-29 

special element 2-9; 3-4 

USE 4-27 

USELCM 4-28 
Location field 

listing 11-6 

statement 2-1 
LO control card option 

description 10-4 

related to LIST 4-65 



LOC pseudo 

description 4-32 

example 4-33,51 

location counter changed 3-4 
Logical difference instruction 8-28 
Logical functions, PPU 9-4 
Logical minus 2-13,22 
Logical product ins truction 8-27 
Logical prod and comp instruc 8-29 
Logical record B-l 
Logical shift instruction 8-31,32 
Logical sum instruction 8-28 
Long add unit 

description 8-4,7 

instructions 8-38 
LPC instruction 

description 9-9 

logical function 9-5 
LPN instruction 

description 9-8 

logical function 9-5 
LT IF operator 4-57 

IFC operator 4-61 
LT instruction 8-25 
LXi instruction 8-31,32 

example 2-19 

M base option 4-20 
M list option 4-67 
Macro 

body 5-13 

call 5-18,25 

equivalenced 5-24 

definition 5-13 

header 5-14 

list control 4-67 

name 2-2; 5-15,18,25; 6-1 

permissible anywhere 4-2 

processing 5-1,14 

system defined 4-16; 5-36 

terminator 5-14 
MACROE pseudo 

description 5-24 

example 5-27 

IRP related 5-35 

operation code table entry 6-1 

permissible anywhere 4-2 
MACRO pseudo 

description 5-15 

example 4-24,62; 5-5,19,20,21,22,33,35,36 

IRP related 5-35 

operation code table entry 6-1 

permissible anywhere 4-2 
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Mask instruction 8-41 
Mass storage, system 1-3 
Master list control 4-67 
MAX pseudo 

description 4-37 

listing 11-7 
MI instruction 8-24,25 
MIC attribute 4-60 
MICCNT pseudo 

description 4-39 

example 4-39 

listing 11-7 

permissible anywhere 4-2 
MICRO 

BASE 4-19 
DATE 7-5 
decimal 7-4 
definition 4-19; 7-2 

editing 2-4 

mark 2-4; 5-1 

octal 7-4 

reference 7-1 

size 4-39; 7-2 

system defined 4-16; 7-2 

test for 4-60 
MICRO pseudo 

description 7-2 

example 4-39; 5-11; 7-2,3 

permissible anywhere 4-2 
MI instructions 8-23,25 
MEN pseudo 

description 4-38 

listing 11-7 
Minus as local separator 5-32 
Minus as parameter separator 5-8,13,16, 

25,28 
Minus on listing 11-7 
Minus operator 2-22,23; 8-5 
Minus sign in location field 

CPU instruction 3-4,5; 4-49 

PPU instruction 3-5; 4-49 

VFD instruction 4-49 
MJ instruction 8-17 

force upper 3-5 
MJN instruction 

description 9-6 

effect of J 4-7 
Mnemonic operation code 

legal operation field entry 2-1 

OPDEF defined 5-27 

search for 6-1 
Modifiers, numeric data 2-19 
MODIFY common decks 5-2 



Multiple entry point table 
description B-12 
suppression 4-19 
used for overlays 3-14 

MXi instruction 

description 8-41 
example 2-19; 8-41 

MXN instruction 

description 9-10 

N eject mode 10-4 
N error 11-11 
N. list option 4-68 
Name 

block 4-26 

different types 2-5 

duplicate code 5-7,8 

general description 2-5 

IF sequence 4-55 

macro 5-16 

micro 4-19; 7-2,4,5 

mnemonic operation 6-1 

overlay 4-10,14 

parameter 5-8 

remote code 5-3 
NE instruction 8-25 
NE IF operator 4-57 

IFC operator 4-61 
Nesting, level of 1-3 
NG instruction 8-24, 25 
NIL pseudo 6-6 

permissible anywhere 4-2 
NIM instruction 9-18 
NJN instruction 

description 9-6 

effect of J 4-7 
NO eject option 10-3 
NO instruction 8-43 
NOLABEL pseudo 

description 4-18 
permissible anywhere 4-2 
NOM instruction 9-18 
NOREF pseudo 4-71 

permissible anywhere 4-2 
Normalize instruction 8-33, 34 
Normalize unit 

description 8-7 
instructions 8-33, 34 
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Not equal sign 

parameter separator 5-8,13 
special character 2-4 

Numeric data 2-17 

NXi instruction 8-34 

NZ instruction 8-23,25 

Obase 2-19,20; 4-19 
O error 11-10 
Omode 10-4 
OAM instruction 9-21 
OAN instruction 9-20 
OBj instruction 8-22 
Octal listing 11-6 
Octal notation 2-19 
OCTMIC pseudo 7-4 

permissible anywhere 4-2 
Opdef 

body 5-13 

call 5-30 

definition 5-13 

heading 5-14 

list control 4-67 

processing 5-14 

system defined 4-16 
OPDEF pseudo 

description 5-27 

example 5-29,30,31,32 

operation code table entry 6-1 

permissible anywhere 4-2 
Operand registers 8-8 
Operation code table 6-1 
Operation code value 

CPU 6-8; 8-1 

PPU 6-4; '9-1 
Operation, definition 

compressed 5-1 

duplicated text 5-6 

external text 5-2 

general description 5-1 

macro definition 5-13 

opdef definition 5-13 

remote text 5-3 

system 5-36 
Operation field 

blank 4-43 

description 2-1 

search 6-1 



Operator 

element 2-22 

mnemonic 5-27; 6-7 

register 2-23; 5-28; 6-7 

term 2-22 
Operator with constant 2-13,17 
OPL file 5-2; 10-3 
OPSYN pseudo 

description 6-5 

permissible anywhere 4-2 
ORG pseudo 

description 4-29 

determine blocks 3-1 

establish absolute blocks 3-2; 4-29 

example 4-4,7,12,15,28,29,41 

location counter changed 4-29 

origin counter changed 3-3; 4-29 
Origin 

multiply entry point 4-3; B-12 

overlay 4-11,14; B-12 

program 4-3; B-12 
Origin counter 

BSS 4-31 

control 3-3, 4-29 

description 3-3 

final value, absolute 3-7 

final value, relocatable 3-5 

forced upper 3-4,5 

maximum value 3-7 

ORG 4-29 

special element 2-9; 3-3 

USE 4-27 
OR instruction 8-24 
ORM instruction 9-18 
Overflow error 2-18 
Overlay 

absolute 3-7 

binary format B-ll 

entry point 4-10,14 

general description 3-7 

level numbers 3-9; 4-4,10,13 

multiple entry point 3-14 

name 4-10,14 

origin 4-10,13 

PPU 3-9 

primary 3-9; 4-11,14 

secondary 3-9; 4-11,14 
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Overlay control table 
description B-ll 
suppression 4-19 

P error 11-11 

P numeric data modifier 2-18 

P pagination mode 10-4 

Pack instruction 8-36 

Padding of CPU word 3-4; 4-49; 8-2 

Page heading 11-1 

Page number 11-1 

Pagination control 10-4 

Parameter 

actual 5-7,18,26 

embedded 5-18,26 

formal 5-8,13 

indefinitely repeated 5-35 

iterative 5-18,26,35 

substitutable 5-8,13,16,25,28,35 
Parameter mark 5-9,13 
Parameter, null 5-9,18,26 
Parameter separator 

actual 5-18,26 

formal 5-8,13,16 
Parcel 8-1 
Parentheses 

local symbol separator 5-32 

nested 5-9 

parameter separator 5-8,13,16,25,28 
Partial binary 

IDKNT type 3-15 

SKG type 3-14 
Pass instruction 

CPU 8-43 

PPU 9-9 
Pass one 

expression evaluation 2-23,26; 3-3 

general description 1-3 

maximum test 4-37 

minimum test 4-38 

symbol definition 2-6 
Pass two 

expression evaluation 2-23,26; 3-3; 8-2 

general description 1-3 

symbol definition 2-6 

value for MAX 4-37 

value for MIN 4-38 
PER1PII pseudo 

description 4-9 

effect on branch instructions 9-5 

example 4-45,65 

first statement group 4-2 



PIDL table B-3 
PJN instruction 

description 9-6 

effect of J 4-7 
PL instruction 8-24,25 
Plus in location field 

CPU instruction 3-4 

PPU instruction 3-5 

VFD instruction 4-49 
Plus as parameter separator 5-8,13,16,25,28 
Plus as local name separator 5-32 
Plus on listing 11-7 
Plus operator 2-22, 23; S-5 
Point 

binary 2-17,18 

decimal 2-18 

octal 2-18 

parameter separator 5-8,13,16,25,28 

register designator 2-8 
Population unit 8-44 
Position counter 

control 4-34,49 

description 3-4 

special element 2-9; 3-4 
POS pseudo 4-34 
Post radix 2-18 
PPOP pseudo 

description 6-3 

example 5-12; 6-4 

permissible anywhere 4-2 
PPU instructions 9-1 

A-register I/O 9-20 

block I/O 9-20 

branch I/O 9-17,18 

branch 9-5 

central read/write 9-16 

channel function 9-22 

constant mode 9-9 

designators 9-3 

direct address 9-13 

error stop 9-23 

exchange jump 9-10 

execution times A-l 

format 9-1 

functions 9-3 

indexed direct address 9-15 

indirect address 9-14 

jump 9-7 

no address 9-8 

no operation 9-9 

output record flag 9-22 

shift 9-7 
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PPU pseudo 

description 4-7 

effect on branch 9-5 

example 4-8,47 

first statement group 4-2 
Prefix table 

binary format B-2 

comments 4-18 

generation 3-7 

suppression 4-19 
Pre radix 2-19 
Program, absolute 3-7; 4-6 
Program execution 10-5 
Program identification 4-3; B-3 
Program origin 4-3 
Program, relocatable 3-5 
Program stop instruction 8-11 
Program structure 3-1 
Pseudo instructions 

binary control 4-6 

block counter control 4-26 

definition operation 5-1 

first statement group 4-2 

introduction 4-1 

micro 7-1 

mode control 4-19 

operation code table management 6-1 

operation field entry 2-2 

permissible anywhere 4-2 

required 4-2 

subprogram identification 4-2 

types 4-1 
PS instruction 

description 8-11 

force upper 3-4,5 
PSN instruction 9-9 
PURGDEF pseudo 

description 6-9 

permissible anywhere 4-2 
PURGMAC pseudo 

description 6-6 

example 6-5 

permissible anywhere 4-2 
Push down stack 1-3 
PXi instruction 8-36 

Q to represent expression 5-27; 6-7 
Qualifier, symbol 4-22 

used for definition operations 5-2 
QUAL pseudo 

description 4-22 

example 4-12,23; 5-22 

permissible anywhere 4-2 



R error 11-10 
R list option 4-68 
R= pseudo 

description 4-51 
example 4-52; 5-21 
illegal in PPU program 4-7 , 8 
RAD instruction 

description 9-13 

replace function 9-5 
Radix 2-19,20 
RAI instruction 

description 9-14 

replace function 9-5 
RAM instruction 

description 9-15 

replace function 9-5 
Real-time clock set instruction 8-20 
Record name, external text 5-3 
Recursion level 1-3; 5-1 
Recursion stack 1-3; 5-1 
Reference 

macro 5-18 

macroe 5-25 

nested 5-1 

opdef 5-30 
Reference table, symbolic 11-13 
Registers, CPU 2-8; 8-8 
Register designators 

CPOP 6-7 

description 2-8; 8-8 

not symbols 2-6 

OPDEF 5-27 

OPSYN 6-9 

PURGDEF 6-9 
RE instruction 

description 8-14 

force upper 3-4 
REL attribute 4-59 
Relocatable binary format B-l 
Relocatable program structure 3-5 
Relocation bytes B-5, 8 
Remote assembly 5-3 
Repeat count 

DUP 5-7 

replication 4-54; B-7 
REPI pseudo 

description 4-53 

illegal if absolute 4-6, 7, 8 
REPL table B-7 

result of BSSZ 4-44 

result of REP or REPI 4-53 

written by SEGMENT 4-14 
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Replace functions, PPU 9-5 
Replication of code 4-54 
Replication table B-7 
REP pseudo 

description 4-53 

illegal if absolute 4-6,7,8 
Return jump, CPU 8-13 
RFN instruction 9-22 
RI instruction 8-20 
Right shift 8-31,33 
RJ instruction 

description 8-13 

example 4-27; 5-21; 8-13 

force upper 3-5 
RJM instruction 9-6 
RL instruction 8-15 
RMT pseudo 

description 5-3 

example 5-5,6 

permissible anywhere 4-2 
RO instruction 8-21 
Round and normalize instruction 8-34 
RPN instruction 9-11 
RXi instructions 

add 8-38 

divide 8-43 

multiply 8-40 
RXj instruction 8-18 

S list option 4-68 

S numeric data modifier 2-18 

S storage flag 11-14 

S systems text mode 10-4 

SAi instructions 

description 8-44 

example 2-15,16,20; 4-27,31; 5-22,35; 8-45 
SBD instruction 

arithmetic function 9-4 

description 9-13 
SB1 instruction 

arithmetic function 9-4 

description 9-14 
SBi instructions 

description 8-46 

example 2-11,15; 4-52; 8-47 
SBM instruction 

arithmetic function 9-4 

description 9-15 



SBN instruction 

arithmetic function 9-4 
description 9-8 
Scale, binary 2-18 
SCM blank common 3-3 
SCM labeled common 3-2 
SCN instruction 

description 9-8 
logical function 9-5 
SEG pseudo 

binary generation 3-7 
description 4-15 
example 4-16 
force upper 3-5 
illegal in PPU program 4-7, 8 
SEGMENT pseudo 

binary generation 3-7 
description 4-14 
example 4-15 
force upper 3-5 
illegal in PPU program 4-7,8 
overlay structure 3-12 
Semicolon in definition 5-9, 13 
Sequencing 

listing 11-7 
statement 2-1 
SET attribute 4-59 
Set instructions 8-44,46,47 
SET pseudo 

description 4-36 
example 2-9,20; 5-11,22 
listing 11-7 
Shift 

description of unit 8-4, 7 
CPU instructions 8-31,32,33,34,35,36,41 
PPU instructions 9-7 
SHN instruction 9-7 
Short jump limit 4-8 
Shortlist 10-4 
Single precision instructions 
add rounded 8-38 
add unrounded 8-36 
divide rounded 8-42 
divide unrounded 8-42 
multiply rounded 8-40 
multiply unrounded 8-39 
SKIP pseudo 

description 4-63 
permissible anywhere 4-2 
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Slant bar 

local symbol separator 5-32 

operator 2-22,23; 8-5 

parameter separator 5-8,13,16,25,28 
SOD instruction 

description 9 -13 

replace function 9-5 
SOI instruction 

description 9-14 

replace function 9-5 
SOM instruction 

description 9-15 

replace function 9-5 
Space, embedded (see blank) 
SPACE pseudo 

description 4-69 

permissible anywhere 4-2 
Special elements 

FORTRAN call 2-9 

general description 2-9 

in variable field 2-2 

location counter 3-4 

origin counter 3-3 

position counter 3-4 
SST attribute 4-60 
SST pseudo 4-40 

example 4-12 

permissible anywhere 4-2 
Stack, recursion 1-3,5-1 
Statement 

coding conventions 2-3 

comments 2-2 

compressed 5-1 

continuatiqn 2-2 

external source 5-2 

first column 2-1 

first group 4-1 

format 2-1 

listing 11-5 

number assembled 11-9 

size 2-1 

source of 5-1; 10-3 
Statistics, assembler 11-9 
STD instruction 

data transmission function 9-3 

description 9-13 



STEXT pseudo 

description 4-16 
example 4-17 
first statement group 4-2 
STI instruction 

data transmission function 9-3 
description 9-14 
STM instruction 

data transmission function 9-3 
description 9-15 
STOPDUP pseudo 
description 5-9 
example 5-11 
Storage reservation 4-31,43 
String, character 

comparison 4-61 
data generation 4-54 
delimited 2-10,14 
empty 2-14 
micro 2-4 
notation 2-14 
Subprogram length 3-5 
Substitution, micro 7-1 
Subsubtitle 

EJECT 4-69 
listing of 11-1 
QUAL 4-23 
SPACE 4-69 
TITLE 4-70 
TTL 4-71 
Subtitle 

CTEXT 4-70 
listing of 11-1 
TITLE 4-69 
SXi instruction 

description 8-47 
example 2-15,19; 5-21,35; 8-48 
Symbol 

attribute 2-6; 4-58,34 
created 5-33 
default 2-7 
definition 2-6; 4-34 
duplicate 2-6 
entry point 2-6 
external 2-7 
invented 5-33; 11-9 
literals 2-7 
local to macro 5-13,33 
local to QUAL 3-1 
location field 2-6 
lost 11-9,13 
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number defined 11-9 

number referenced 11-9 

previously defined 2-8 

qualified 2-8; 4-22 

redefinition 4-34 

system defined 2-7; 4-40 

undefined 2-8 

value 2-6; 4-34 
Symbol qualifier listed 11-1 
Symbol table 

clearing 3-10,12 

systems text 4-16 
Symbolic reference table 

address reference 4-72 

detailed description 11-13 

general description 4-66 

generation 1-3 

list control 4-67; 10-3,4 

omit symbol 4-70 
Synonymous operation 

CPU 6-9 

mnemonic 6-5 

PPU 6-5 

syntactic 6-9 
Syntax definition 5-27; 6-7,9 
Syntax search 6-1 
Systems text 4-16; B-13 
SYSTEXT option 10-4 

related to G mode 10-3 

related to STEXT 4-16 
T list option 4-68 

Table 

loader B-l 
operation code 6-1 
symbolic reference 11-13 
USE 4-10,15,26,28,29 
TBj instruction 8-20 
Term 2-22 
Term operator 2-22 
Terminator, macro 5-13 
Test symbol attribute 4-59 
Text and data table B-5 
TEXT table B-5 
Time limit 10-2 
TIME micro 7-5 
Time of assembly 11-1 
Times of execution A-l 
CPU instructions A -7 
PPU instructions A-13 



Title 

ES 8-12 

IDENT 4-4 

listing of 11-1 

TITLE 4-70 

PS 8-11 
TITLE pseudo 4-70 

permissible anywhere 4-2 
Transfer symbol 4-5 
Transfer table B-10 
Transmit instruction 8-27 
Truncation, character data 2-13 

expression value 2-26 
TTL pseudo 4-71 

permissible anywhere 4-2 

U error 11-11 
UJN instruction 

effect of J 4-7 

description 9-6 
Unconditional jump 

CPU 8-23 

PPU 9-6 
Underflow error 2-18 
Unpack instruction 8-35 
USA SCII code 

character set D-l 

option 4-22 
USELCM pseudo 

description 4-28 

establish common blocks 3-3 

example 4-28 

illegal in PPU program 4-7,8 
USE pseudo 

change blocks 3-1; 4-26 

description 4-26 

establish common blocks 3-3, 4; 4-26 

establish local blocks 3-2; 4-26 

example 4-16,24,27,28,30; 5-22,36 
USE table 

entry 4-27,28,29 

reinitialization 3-10,12; 4-9 
UXi instruction 8-35 

V error 11-11 
Value, numeric 2-17 
Variable field 2-2 
Variable field definition 4-49 
VFD pseudo 

description 4-49 

example 2-15; 4-21, 24, 27,50; 5-22 
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WE instruction 

description 8-14 

force upper 3-4 
WL instruction 8-15 
WXj instruction 8-18 

X external flag 4-42; 11-7 
X external text mode 10-4 
X file option 

description 10-4 

XTEXT default 5-3 
X list option 4-68 
X register 

conditional instructions 8-23 

description 8-4 

designator 2-8 

setting 8-47 
XFER table B-10 
XJ instruction 

description 8-16 

force upper 3-4,5 
XREF pseudo 

description 4-73 

permissible anywhere 4-2 
XTEXT pseudo 5-1 

related to CTEXT/ENDX 4-72 
XTEXT source 10-4 

Zero block 

absolute program 3-2 

description 3-2 

relocatable program 3-5 
Zeroed words 4-43 
Zero fill 2-14; 4-49 
Zero guaranteed 

data item 2-14 

DIS item 4-45 
ZJN instruction 

description 9-6 

effect of J 4-7 
ZR instruction 
x description 8-24,25 

force upper 3-5 
ZX instruction 8-34 
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PSEUDO INSTRUCTION INDEX 



,-s.. 




- 


Section 






-" 


Section 


Name 


Placement 


Usage ■■--■•■-■ 


Number 


Name - 


Placement 


Usage 


- .-.Njanber.' 


""ABS 


first group 


CPA 


4.3.1 


OPDEF 


anywhere 


CP 


5. 4. 6 


BASE 


anywhere -, 


CP.PP 


4.4.1 


OPSYN 


anywhere 


CP.PP 


6. 1. 2 


BSS 


normal ■■'.'.. '_-■.-':. 


CP.PP 


4.5.4 


ORG 


; normal 


CP, PP 


4.5.3 


BSSZ 


normal 


CP, PP 


4.8.1 


PERIPH 


first group 


■•PP"" '' r 1 - 


4.3.3 


Bl-1 


anywhere 


CP ■•-".--. 


4. 4. 4 


POS 


'normal 


CP, PP 


4.5.6 


B7 1 


anywhere 


CP 


4.4.4 


PPOP 


anywhere 


PP 


6.1.2 


CODE 


anywhere 


CP, PP 


4.4.2 


PPU 


first group 


PP 


4.3.2 


COL 


normal ; 


CP.PP 


4.4.5 


PURGDEF 


anywhere 


CP 


6.2.3 


COMMENT 


" anywhere 


CP.PP 


4.3.9\ 


PlRGMAC 


anywhere 


PP 


6.1.4 


CON 


normal 


CP.PP 


4.8.6 


QUAL 


anywhere 


CP.PP 


4.4^3 


CPdP 


anywhere 


CP 


6.2. L 


REP 


normal 


CPR 


4;8.8-: 


CPRYN 


anywhere 


CP 


6.2.2 


REPI 


normal 


CPR 


4.8.^8 : 


CTEXT 


normal 


CP 


4.11,7 


RMT 


anywhere 


CP, PP 


5.2;r 


DATA 


normal 


CP.PP 


.4.8.2 


R= 


normal 


CP 


4.8.7 ■ 


DECMIC 


anywhere 


CP, PP 


7.2.2 


SEG 


normal 


CPA.PP 


4.3.6 1 


DIS 


normal 


CP;PP 


4.8.3 


SEGMENT 


normal 


CPA, PP 


4.3.5 


DIP 


normal 


CP.PP 


5.3.1 


SET 


normal 


CP.PP 


4i6.2 


ECHO 


normal 


CP.PP 


5.3.2 


SKIP 


anywhere 


CP, PP 


4.9.8 


EJECT 


anywhere 


CP.PP 


4. 11. 2 


SPACE 


anywhere 


CP.PP 


4.11.3 


ELSE* 


anywhere 


CP.PP 


4.9.2 


SST 


anywhere 


CP.PP 


4.6.6 


END* 


required Vast 


CP.PP 


4.2.2 


STEXT 


first group 


CP.PP 


4.3.7 


KNDD 


anywhere 


CP.PP 


5.3.4 


STOPDUP 


normal 


CP.PP 


5.3.3 


ENDI F+ 


anywhere 


CP.PP 


4.9.1 


TITLE 


anywhere 


CP, PP 


4.11.4 


ENDM 


anywhere 


CP.PP 


5.4.1 


TTL 


anywhere 


CP.PP 


4.11.5 


ENDX 


normal 


CP.PP 


4.11.7 


USE 


normal 


CP.PP 


4.5.1 


ENTRY 


normal 


CP.PP 


4.7.1 


USELCM 


normal 


CP 


4. 5. 2 


EQC 


normal 


CP.PP 


4.6.1 


VFD 


normal 


CP.PP 


4.8.5 


ERR 


normal 


CP.PP 


4.10.1 


XREF 


anywhere 


CP.PP 


4.11.8 


ERRNG 


normal 


CP.PP 


4.10.2 


XTEXT 


normal 


CP.PP 


5.1 


ERRNZ 


normal 


CP.PP 


4.10.2 


(blank) 


normal 


CP.PP 


4.8.1 


ERRPL 


normal 


CP.PP 


4.10.2 


= 


normal 


CP.PP 


4.6.1 


ERRZR 


normal 


CP.PP 


4.10.2 










EXT 


normal 


CP.PP 


4.7.2 










HERE 


anywhere 


CP.PP 


5.2.2 










IDENT 


required first 


CP.PP 


4. 2. 1 and 4. 3. 4 










IF 


normal 


CP.PP 


4.9.5 










IFC 


anywhere 


CP.PP 


4.9.6 










IFCP 


normal 


CP.PP 


4.9.3 










1FGE 


normal 


CP.PP 


4.9.4 










IFCT 


normal 


CP.PP 


4.9.4 










1FLE 


normal 


CP.PP 


4.9.4 










IFLT 


normal 


CP.PP 


4.9.4 










IFMI 


normal 


CP, PP 


4.9.7 










1 IFNE 


normal 


CP, PP 


•4.9.4 










1 IFPL 


normal 


CP, PP 


4.9,7 










■ IFPP 


normal 


CP.PP 


4.9.3 










IFEQ 


normal 


CP.PP 


4.9.4 










IRP 


anywhere 


CP.PP 


5.4.9 










LCC 


normal 


CPR 


4.3.8 










LIST 


anywhere 


CP.PP 


4.11.1 


Legend 






LIT 


normal 


CP, PP 


4.8.4 










1£>C 


normal 


CP.PP 


4.5.5 


CP 


Absolute or relocatable CPU program 




LOCAL 


macro or opdef 


CP.PP 


5.4.8 


CPA 


Absolute CPU program 






MACRO 


anywhere 


CP, PP 


5.4.2 


CPR 


Relocatable CPU program 




MA.CROE 


anywhere 


CP.PP 


5.4.4 


PP 


Absolute PPU program 






MAX 


normal 


CP.PP 


4.6.3 










MtCCNT 


anywhere 


CP.PP 


4.6.5 










MICRO 


anywhere 


CP.PP 


7.2.1 










MIN 


normal 


CP.PP 


4.6.4 










NIL 


anywhere 


CP.PP 


6.1.3 










.NO LA BEL 


anywhere 


CP.PP 


4.3.10 










NOREF 


anywhere 


CP.PP 


4.11.6 










OCTMIC 


anywhere 


CP.PP 


7.2.3 










I .ix)kf>H foi 


finriniT ! I 7 ckinnincr. 















